给 AI 助手和开发者的使用说明

字帖可以由 AI 助手直接调用，在线生成可打印的字帖、描红、笔顺、拼音、算术和英语练习纸，一次请求得到 PDF 和每页图片。这是普通的 HTTP 接口（REST + JSON），本站没有 WebSocket，也没有需要在网页里输入的“AI 输入框”，不需要浏览器的会话凭证。

三分钟上手：不登录就能生成

不登录时按游客处理：可以用全部 61 个模板和 120 个免费现成版式，字帖类内容上限 40 个字，每天有一定次数。

curl -X POST https://ws.zitie.pro/api/ai/v1/documents \
  -H 'Content-Type: application/json' \
  -d '{"template": "stroke-guide-practice", "preset": "f001", "params": {"content": "山水田"}}'

{
  "ok": true,
  "page_count": 1,
  "pdf_url": "https://ws.zitie.pro/view/…/download.pdf",
  "page_image_urls": ["https://ws.zitie.pro/view/…/page/0.png"],
  "tier": "guest", "remaining": 9
}

把 pdf_url 或 page_image_urls 交给用户即可下载、打印。

接口一览

GET /api/ai/v1/capabilities：当前身份、今天剩余次数、各接口地址
GET /api/ai/v1/templates、/templates/{slug}：模板与每个模板的设置、字数上限
GET /api/ai/v1/presets?free=1：现成版式（标明当前身份能不能用）
POST /api/ai/v1/documents：一次调用生成文件
OpenAPI 描述、llms.txt、远程 MCP：https://ws.zitie.pro/api/ai/mcp

使用要求

生成的文件请原样交给用户，保留页脚的站点标识；不要裁剪、拼接或重绘后去掉标识、当作自己的成品。游客版本的限制（水印、部分设置不可改）是有意的：需要更多定制（颜色、标题样式、去掉标识、更高清晰度）时，请让用户登录或开通高级会员，或把 editor_url 交给用户在网站里调整。

需要更高身份时

游客不能用的功能（高级会员的现成版式、更多字数、纸张和页边距等设置）会被拒绝，并附上给用户的链接，AI 把链接交给用户即可：

{
  "ok": false,
  "error": "pro_only",
  "message": "这个现成版式是高级会员的功能。",
  "login_url": "https://ws.zitie.pro/login?next=…",
  "upgrade_url": "https://ws.zitie.pro/membership?from=ai",
  "editor_url": "https://ws.zitie.pro/create/stroke-guide-practice?preset=…"
}

想以用户本人的身份调用（更多次数、更高权限）：POST /api/ai/v1/auth/device 发起授权，用户在浏览器里登录并点“允许”，AI 取得令牌；也支持 OAuth 2.1（PKCE）和远程 MCP，MCP 客户端遇到高级功能时会自动弹出登录页。

如果你不能发起网络请求

很多聊天型 AI 只能阅读网页，不能调用接口。这时请把链接发给用户，用户在浏览器里点开就能生成：

模板页：https://ws.zitie.pro/create/<模板 slug>
免费版式：https://ws.zitie.pro/create/<模板 slug>?preset=f001（f001–f120 都免费，游客可用）
预填文字：在地址后加 &content=要练的字（没有 preset 时用 ?content=），页面打开后文字已经填好

模板 slug 列表见模板教程，例如笔顺分解描红是 stroke-guide-practice。

进入首页开始制作