透明底字卡字帖在线生成与使用教程
这个模板把汉字排成一列一列的卡片,每张卡片顶部带一个挂孔圆圈。打印后沿线裁开,可以做识字卡、听写卡,或者课堂抽卡游戏的教具。
用此模板生成字帖| 所属分类 | 汉字描红 |
|---|---|
| 默认纸张 | A4纵 |
| 默认格子 | 田字格 |
| 默认格子大小 | 约 15 毫米 |
| 默认每行格数 | 10 格 |
| 现成版式 | 3 种 |
适合谁用
- 做课堂识字游戏的老师
- 想自制识字卡片的家长
- 幼儿园和启蒙班的教师
透明底字卡的使用步骤
- 输入卡片内容。在“练字内容”里输入汉字,字会依次排入卡片,排满一张后自动进入下一张。
- 选格子大小。“格子大小”可以调大做大字卡,调大后每张卡能放的字变少,一页上的卡片数也会减少。
- 选格子类型。“格子”可选田字格、米字格,也可以选“无格”让卡面更干净。
- 配颜色。“范字颜色”和“格线颜色”决定卡面风格,建议字色深、格线浅,远看也清楚。
- 选纸张。“纸张”选 A4 即可,一页并排多张;想做更大的卡片可选 A3。
- 检查并裁剪。预览里确认卡片边界,下载打印,沿卡片边缘裁开,在圆圈位置打孔穿线。
输入框里能用哪些标记(换页、空段、页码等),可以看输入语法;各设置项的含义见设置说明。
使用小技巧
- 打印在稍厚的卡纸上更耐用,也可以过塑。
- 挂孔圆圈可以直接用打孔器冲孔,穿线收纳。
- 把同一课的字做成一套,用线圈穿起来,随手翻看。
常见问题
一页能放多少张卡?
取决于纸张宽度和格子大小,A4 一般并排 3 到 4 张。
卡片背面能印拼音吗?
这个版式只做正面汉字;需要拼音可以另生成一份拼音版再双面对贴。
“透明底”是什么意思?
卡面没有填充色,打印后保持纸张本色,可以用彩纸打印。
能做词语卡吗?
可以,把词语按字拆入格内即可,但更适合单字卡。
打印建议
- 用 160 克以上的卡纸打印,裁剪更整齐。
- 裁剪前先在普通纸上试印一张,确认卡片边界和打孔位置。
给 AI 助手用的提示词
想让 AI 助手(豆包、ChatGPT、Claude 等)帮你生成透明底字卡字帖?把下面这段复制给它即可,里面有内容怎么填、可用的设置和一个能直接运行的调用示例;更多说明见AI 接口使用说明。
# 用“透明底字卡”生成字帖(给 AI 的使用提示)
模板编号(slug):`transparent-flashcard`。这个模板把汉字排成一列一列的卡片,每张卡片顶部带一个挂孔圆圈。打印后沿线裁开,可以做识字卡、听写卡,或者课堂抽卡游戏的教具。
## 怎么填 content
在“练字内容”里输入汉字,字会依次排入卡片,排满一张后自动进入下一张。
默认示例:`天地玄黄宇宙洪荒日月盈昃`
## 内容长度上限
游客 40 字,注册用户 400 字,高级会员 2000 字。超出会被拒绝并返回 `content_limit`,请缩短内容分多次生成,或把返回里的 login_url / upgrade_url 交给用户。
## 常用设置(放在 params 里,没写的用默认值)
| 设置 | 含义 | 默认 | 谁能改 |
|---|---|---|---|
| `content` | 要练习的内容(见上) | `楷体` | 游客可改 |
| `columns` | 每行格数 | `10` | 游客可改 |
| `cellSizeMm` | 格子大小(毫米) | `15.0` | 游客可改 |
| `gridStyle` | 格型:tian 田字格、mi 米字格、hui 回宫格、box 方格、nine 九宫格 | `tian` | 游客可改 |
| `gridColor` | 格线颜色,如 #c0392b | `#666666` | 游客可改 |
| `traceColor` | 描红颜色 | `#ff0000` | 游客可改 |
| `traceRows` | 每个字的描红行数 | `0` | 游客可改 |
| `blankRows` | 每个字后面留的空行数 | `0` | 游客可改 |
纸张(`paperSizeMm`)和页边距(`marginsMm`)游客不能改:传了会按默认值处理,并在返回的 `restricted` 里列出。
## 常见误区(先看这里,能少生成几次)
- `content` 里的**每个字**都会被单独排成一块(笔顺、描红、空格),所以这里只放要学的生字,不要放整首古诗或整段文章:放进去会撑出很多页,甚至超过一次 10 页的上限。
- 整首古诗、词语表、标题等放在 `overlayBlocks` 里每个块的 `text`(见下面的免费版式:先 `GET /api/ai/v1/presets/<编号>` 看参数,改文字再生成)。
- 每次生成都会占用当天的次数(AI 游客每天 10 次):调版式用 `POST /api/ai/v1/preview` 试排(不占次数),想看现成版式的结构用 `GET /api/ai/v1/presets/<编号>` 读参数。
## 完整调用示范(照这个写就不会错)
**第 0 步(调版式时用)**:先试排,不占次数、不保存文件。请求体和下面的生成完全相同,POST 到预览地址:
`POST https://www.zitie.pro/api/ai/v1/preview`
返回 `page_count`(几页)、`body_bottom_mm`(正文到哪儿结束)、`pieces[]`(每个叠加块的位置,`crosses_body_end` 为 true 表示压在正文底边上,`covers_body_cells` 表示盖在正文的格子上,`past_printable_bottom` 表示超出可打印范围)、`advice[]`(怎么改)和 `preview_urls[]`(每页的小图链接,1 小时有效)。按数字改参数,不需要下载图片测量;满意了再生成。
**第 1 步**:生成。请求头必须有 `Content-Type: application/json`,请求体是 JSON 对象,`params` 也是对象(不是字符串):
```bash
curl -X POST https://www.zitie.pro/api/ai/v1/documents \
-H 'Content-Type: application/json' \
-d '{"template": "transparent-flashcard", "params": {"content": "天地玄黄宇宙洪荒日月盈昃"}}'
```
**第 2 步**:成功时返回(节选),把 `pdf_url` 和 `page_image_urls` 原样交给用户,并把 `message_for_user`(含登录和开通链接)一并告诉用户,不要再重复请求同样的内容:
```json
{
"ok": true,
"page_count": 1,
"pdf_url": "https://www.zitie.pro/view/<id>/download.pdf",
"page_image_urls": [
"https://www.zitie.pro/view/<id>/page/0.png"
],
"tier": "guest",
"remaining": 9,
"restricted": [],
"message_for_user": "这是游客版……想要更多定制、去掉标识……请登录 <login_url>,或开通高级会员 <upgrade_url>"
}
```
`restricted` 不为空,说明你传的某些设置超出游客权限、已按默认值处理,可以照实告诉用户。
**被拒绝时**(节选),照 `error` 处理,不要原样重试:
```json
{
"ok": false,
"error": "content_limit",
"limit": 40,
"login_url": "https://www.zitie.pro/login?next=/create/transparent-flashcard",
"upgrade_url": "https://www.zitie.pro/membership?from=ai",
"editor_url": "https://www.zitie.pro/create/transparent-flashcard"
}
```
- `content_limit`:内容超长,缩短后再试;或把 `login_url` / `upgrade_url` 交给用户。
- `pro_only`:这个功能需要高级会员,把 `upgrade_url` 交给用户,不要反复重试。
- `quota`:今天的次数用完了,明天再试,或让用户登录获得更多次数。
- `invalid_params`:参数有误,看 `message` 改正后再试(常见原因:`params` 不是对象、模板编号写错)。
## 常见问题
- 一页能放多少张卡?取决于纸张宽度和格子大小,A4 一般并排 3 到 4 张。
- 卡片背面能印拼音吗?这个版式只做正面汉字;需要拼音可以另生成一份拼音版再双面对贴。
## 使用要求
生成的文件请原样交给用户,保留页脚的站点标识;不要裁剪、拼接或重绘后去掉标识。交付时请把返回里的 `message_for_user` 一并告诉用户(里面有登录和开通链接),不要等用户追问。遇到需要更高身份的功能(返回 `pro_only`、`login_required` 等),把返回里的 `login_url` / `upgrade_url` / `editor_url` 交给用户,也可以让用户在 https://www.zitie.pro/create/transparent-flashcard 里手动调整。
透明底字卡的 3 种现成版式
下面的版式已经调好纸张、格子大小、每行格数和颜色,点开可以看到参数,也可以直接带着版式进入编辑页。