拼音加汉字描写字帖在线生成与使用教程

输入一段文字，系统按行排进格子，每行字的上方标注拼音，下面是浅色描红和空白行。既能边读拼音边描，也能把汉字或拼音隐藏起来，做看拼音写字、看汉字写拼音的小测验。

用此模板生成字帖

所属分类	拼音
默认纸张	A4纵
默认格子	田字格
默认每行格数	12 格
现成版式	5 种

适合谁用

• 低年级学生和家长
• 做听写前预习的老师
• 想练课文抄写的孩子

拼音加汉字描写的使用步骤

1. 粘贴文章或词语。在“练字内容”里粘贴整段课文或句子。换行就是另起一块，空行会变成一行空格子，用来把段落隔开。
2. 选拼音位置。“拼音形式”默认“首行”，每个文字块的上方显示拼音；改成“每行”，则每一行字上方都带拼音，适合长句。
3. 选拼音格。“拼音格”可选虚线格、实线格、下划线等，决定拼音写在什么样的格子里。
4. 排描红与留白。“描红行数”和“留白行数”决定每块练几遍、留几行空白，课文长时描红一遍即可。
5. 定格子与每行字数。“格子”默认田字格，“每行格子数”约 12；课文较长时可调小格子，让每行容纳更多字。
6. 检查读音并打印。核对拼音是否正确。要做听写题，就把拼音或汉字隐藏后再打印。

输入框里能用哪些标记（换页、空段、页码等），可以看输入语法；各设置项的含义见设置说明。

使用小技巧

• 先读拼音再描红，把读音和字形联系起来。
• 做听写题时，隐藏汉字、保留拼音，让孩子写汉字。
• 多音字请在预览中核对读音。
• 课文可以分段，每天练一段。

常见问题

可以只显示拼音吗？

可以，在显示设置里选择隐藏汉字，只留下拼音。

拼音声调会标出吗？

会标出声调，字体支持带调字母。

课文太长怎么办？

会自动分页，也可以拆成几段分别生成。

和拼音汉字笔顺有什么不同？

本模板偏文章整行排版，拼音汉字笔顺偏单字逐个展示。

打印建议

• A4 纵向单面，拼音字号较小，打印前放大预览核对。
• 要做听写卷时，隐藏答案后另存一份，再印一份带答案的备用。

给 AI 助手用的提示词

想让 AI 助手（豆包、ChatGPT、Claude 等）帮你生成拼音加汉字描写字帖？把下面这段复制给它即可，里面有内容怎么填、可用的设置和一个能直接运行的调用示例；更多说明见AI 接口使用说明。

# 用“拼音加汉字描写”生成字帖（给 AI 的使用提示）

模板编号（slug）：`pinyin-character-practice`。输入一段文字，系统按行排进格子，每行字的上方标注拼音，下面是浅色描红和空白行。既能边读拼音边描，也能把汉字或拼音隐藏起来，做看拼音写字、看汉字写拼音的小测验。

## 怎么填 content
在“练字内容”里粘贴整段课文或句子。换行就是另起一块，空行会变成一行空格子，用来把段落隔开。
默认示例：`天地玄黄，宇宙洪荒。日月盈昃，辰宿列张。寒来暑往，秋收冬藏。…`

## 内容长度上限
游客 40 字，注册用户 400 字，高级会员 2000 字。超出会被拒绝并返回 `content_limit`，请缩短内容分多次生成，或把返回里的 login_url / upgrade_url 交给用户。

## 常用设置（放在 params 里，没写的用默认值）
| 设置 | 含义 | 默认 | 谁能改 |
|---|---|---|---|
| `content` | 要练习的内容（见上） | `在这里输入要练习的内容，下方可以选择隐藏拼音或汉字。` | 游客可改 |
| `columns` | 每行格数 | `12` | 游客可改 |
| `cellSizeMm` | 格子大小（毫米） | `null` | 游客可改 |
| `gridStyle` | 格型：tian 田字格、mi 米字格、hui 回宫格、box 方格、nine 九宫格 | `tian` | 游客可改 |
| `gridColor` | 格线颜色，如 #c0392b | `#e4803e` | 游客可改 |
| `traceColor` | 描红颜色 | `#cccccc` | 游客可改 |
| `traceRows` | 每个字的描红行数 | `1` | 游客可改 |
| `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": "pinyin-character-practice", "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/pinyin-character-practice",
  "upgrade_url": "https://www.zitie.pro/membership?from=ai",
  "editor_url": "https://www.zitie.pro/create/pinyin-character-practice"
}
```
- `content_limit`：内容超长，缩短后再试；或把 `login_url` / `upgrade_url` 交给用户。
- `pro_only`：这个功能需要高级会员，把 `upgrade_url` 交给用户，不要反复重试。
- `quota`：今天的次数用完了，明天再试，或让用户登录获得更多次数。
- `invalid_params`：参数有误，看 `message` 改正后再试（常见原因：`params` 不是对象、模板编号写错）。

## 常见问题
- 可以只显示拼音吗？可以，在显示设置里选择隐藏汉字，只留下拼音。
- 拼音声调会标出吗？会标出声调，字体支持带调字母。

## 使用要求
生成的文件请原样交给用户，保留页脚的站点标识；不要裁剪、拼接或重绘后去掉标识。交付时请把返回里的 `message_for_user` 一并告诉用户（里面有登录和开通链接），不要等用户追问。遇到需要更高身份的功能（返回 `pro_only`、`login_required` 等），把返回里的 `login_url` / `upgrade_url` / `editor_url` 交给用户，也可以让用户在 https://www.zitie.pro/create/pinyin-character-practice 里手动调整。

拼音加汉字描写的 5 种现成版式

下面的版式已经调好纸张、格子大小、每行格数和颜色，点开可以看到参数，也可以直接带着版式进入编辑页。

• A3横，田字格，12列，识字·1，青绿
• A4纵，米字格，14列，识字·2，松绿
• A4横，回宫格，16列，识字·3，赭石
• A5纵，方格，8列，识字·4，紫红
• B5纵，九宫格，10列，识字·5，朱红

相关模板

• 拼音加汉字笔顺

  带拼音标注的笔顺练习。

  3 种现成版式

• 整篇文章描红

  按文章内容逐字描红练习。

  5 种现成版式

• 拼音加汉字组词

  带拼音标注的组词练习。

  36 种现成版式

返回：拼音字帖模板 · 全部模板与教程