横向排列词语（带拼音）字帖在线生成与使用教程

每个词以条状排布：先是一条示范条，然后是描红条，末尾是空白条，像排文字一样顺着页面宽度横向排列，词上方带拼音。比词语描红更紧凑，适合一页练很多词。

所属分类	词语训练
默认纸张	A4纵
默认格子	田字格
默认格子大小	约 15 毫米
现成版式	29 种

适合谁用

小学低中年级学生
做词语积累的家长
想要紧凑排版的老师

横向排列词语（带拼音）的使用步骤

输入词语。在“练字内容”里输入词语，用逗号分隔，例如春天，夏天，秋天，冬天，花朵，小草。
设置拼音。“拼音形式”选“首行”，拼音显示在每个词的上方。
定格子大小。“格子大小”默认约 15 毫米，词条之间会顺着页面宽度排满一行再换行。
用空行补满。“填充尾页”可以用空行把末页补满，减少打印浪费。
排描红与留白。“描红行数”“留白行数”控制每个词的练习量。
预览并打印。核对每个词的拼音，再打印。

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

使用小技巧

词语较短时一行能排多个词，同一页的内容更多。
拼音字号要清晰，打印前放大预览看一眼。
先读词，再描红，再默写。

常见问题

每行能放多少个词？

取决于词的长度和纸张宽度，系统自动排布。

必须带拼音吗？

不必，把“拼音形式”设成不显示即可。

与“词语描红”有什么区别？

本模板横向流式排布，更紧凑；词语描红每个词单独成块，信息更丰富。

多音字拼音正确吗？

拼音按内置资料和词语语境给出，多音字词语请在预览中核对，如与教材不同可以手动改。

打印建议

A4 横向打印更舒展。
可双面打印，节约纸张。

给 AI 助手用的提示词

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

# 用“横向排列词语（带拼音）”生成字帖（给 AI 的使用提示）

模板编号（slug）：`horizontal-word-formation-sheet`。每个词以条状排布：先是一条示范条，然后是描红条，末尾是空白条，像排文字一样顺着页面宽度横向排列，词上方带拼音。比词语描红更紧凑，适合一页练很多词。

## 怎么填 content
在“练字内容”里输入词语，用逗号分隔，例如春天，夏天，秋天，冬天，花朵，小草。
默认示例：`春天，夏天，秋天，冬天，花朵，小草，白云，蓝天，河流，山林，…`

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

## 常用设置（放在 params 里，没写的用默认值）
| 设置 | 含义 | 默认 | 谁能改 |
|---|---|---|---|
| `content` | 要练习的内容（见上） | `春天，夏天，秋天，冬天，花朵，小草，白云，蓝天，河流` | 游客可改 |
| `columns` | 每行格数 | `99` | 游客可改 |
| `cellSizeMm` | 格子大小（毫米） | `15.0` | 游客可改 |
| `gridStyle` | 格型：tian 田字格、mi 米字格、hui 回宫格、box 方格、nine 九宫格 | `tian` | 游客可改 |
| `gridColor` | 格线颜色，如 #c0392b | `#60ba87` | 游客可改 |
| `traceColor` | 描红颜色 | `#f9cbcb` | 游客可改 |
| `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/<编号>` 读参数。

## 现成的免费版式（preset）
在请求里加 `"preset": "<编号>"`，版式的参数会先套上，你的 `params` 再覆盖。要看参数、按需改里面的文字：`GET https://www.zitie.pro/api/ai/v1/presets/<编号>`。
- `f023`：基础·古诗，A4纵，低年级，15mm，赭石，静夜思
- `f024`：基础·听写加订正，A4纵，低年级，15mm，赭石，咏鹅
- `f048`：基础·成语加默写，A4纵，低年级，15mm，赭石，池上
- `f056`：基础·横线，A4纵，低年级，15mm，赭石，早发白帝城
- `f084`：基础·词语表，A4纵，低年级，15mm，紫红，咏鹅
更多：`GET https://www.zitie.pro/api/ai/v1/presets?template=horizontal-word-formation-sheet&free=1&q=关键词`。

## 完整调用示范（照这个写就不会错）
**第 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": "horizontal-word-formation-sheet", "params": {"content": "春天，夏天，秋天，冬天，花朵"}, "preset": "f023"}'
```
**第 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/horizontal-word-formation-sheet",
  "upgrade_url": "https://www.zitie.pro/membership?from=ai",
  "editor_url": "https://www.zitie.pro/create/horizontal-word-formation-sheet"
}
```
- `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/horizontal-word-formation-sheet 里手动调整。

横向排列词语（带拼音）的 29 种现成版式

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

第 1 至 12 种版式

第 13 至 24 种版式

第 25 至 29 种版式