贴图号公众号爆款套图生成

概述

1. 能力概述

给一个主题或一篇文章，产出一整套图，而不是一张：

输入：主题 / 公众号文章正文 / 文章链接
  ↓  ① 先由大模型生成图文大纲（1 页封面 + N 页内容）
  ↓  ② 按「拼图档」把内容页分桶
输出：一批图片
  - 第 1 张：封面（含标题/副标题，专业排版）
  - 之后每张：1 页或 2/3/4 页合成一张（分镜式排版）

典型用途：公众号图文、小红书轮播、多图笔记、系列图、内容九宫格。

所有实际操作都通过 scripts/tietu.py --mode set 完成。不要再自己写 curl 或直接请求后端。

如果你还想要「一张爆款贴图」或「按提示词 AI 生图」，那是另一个技能（tietuzhushou，贴图助手）的活。本技能只做套图。

2. 何时使用 / 触发词

只要用户表达了下列任一意图，就调用本技能：

• 成套类：套图、做套图、一整套图、系列图、成套的图、配一整套插图
• 图文类：公众号图文、图文笔记、小红书图文、小红书轮播、轮播图、多图笔记、九宫格
• 转化类：把这篇公众号文章做成一套图、把这个主题做成一组图、文章配一整套图

注意区分：用户说「做一张贴图 / 一张封面 / 一张图」→ 用贴图助手（tietuzhushou）；说「一套 / 一组 / 多张 / 轮播」→ 用本技能。

3. 使用前配置（拿到 TZ_API_KEY）

技能需要一把 API Key —— 与贴图助手技能共用同一把，已装过那个技能的话直接用，不必重新申请。

没有 key 时脚本会以退出码 2 退出，此时：

1. 引导用户打开授权页 https://pix.aib.cn/skillhub 用微信扫码登录（与小程序同一账号），页面会自动签发一把绑定其账号的密钥并显示明文
2. 让用户把密钥填入技能目录下的 config.json：

   { "TZ_API_KEY": "sk-tz_xxxxxxxx" }

或设置环境变量 TZ_API_KEY（优先级高于 config.json）

⚠️ 账号需有积分才能出图：新账号积分为 0，调用会以退出码 4（额度不足）失败。

积分可免费获取：小程序内「每日签到」「看广告」都能领，「邀请好友」另有奖励，也可充值。

4. 标准流程（创建 → 轮询）

核心：创建与查询必须分成两段，禁止一次调用阻塞到出图。

第 1 步：创建任务（--only-create，立刻拿到 task_id）
   python scripts/tietu.py --mode set --topic "<主题或文章>" --only-create
   → 退出码 10，输出里有 task_id

第 2 步：轮询（单次 ≤90s，未出图就再轮一次）
   python scripts/tietu.py --task <task_id>
   → 退出码 0（全部成功）/ 14（部分成功）/ 12（全部失败）/ 13（仍在进行，继续轮询）

⚠️ 最重要的一条：退出码 10 / 13 / 14 都不是「失败」

• 10 = 任务已创建但还没跑完 → 必须继续轮询
• 13 = 这一轮还没到终态 → 必须继续轮询
• 14 = 部分成功：已经出了一部分图、还有个别批次失败 → 先把已出的图交付给用户，再告诉他可以补

⚠️ 套图比单图慢得多，要有耐心

一套图要逐张生成（1 张封面 + 若干张内容页），出图时间通常是单张爆款贴图的 2~5 倍。--task 一轮 90s 往往不够，需要连续轮询好几轮。这是完全正常的，不要报「失败」。

轮询可以断点续跑：任何一次调用超时后，重复执行同一条 --task <id> 命令即可接着轮询，不会重复扣点。

5. 命令速查

示例：

# 先报价（不创建任务）
python scripts/tietu.py --mode set --topic "秋天的第一杯奶茶" --count 4 --grid 2 --dry-run

# 主题做成一套图（内容页两页拼一张）
python scripts/tietu.py --mode set --topic "秋天的第一杯奶茶" --count 6 --grid 2 --only-create

# 公众号文章链接做成一套图
python scripts/tietu.py --mode set --topic "https://mp.weixin.qq.com/s/xxx" --count 4 --only-create

# 专业风格
python scripts/tietu.py --mode set --topic "2026 年新能源车出海趋势" --style professional --only-create

（等价 curl 命令见 references/api.md，仅用于排障。）

6. 交付规范

任务成功后必须真正把图片逐张渲染出来交给用户，不能只给文件路径：

✅ 套图完成（set）· 共 4 张

![结果图1](https://sb.aib.cn/uploads/openapi-cover.jpg)
原图链接（第 封面 页）：https://sb.aib.cn/uploads/openapi-cover.jpg

![结果图2](https://sb.aib.cn/uploads/openapi-2.jpg)
原图链接（第 1-2 页）：https://sb.aib.cn/uploads/openapi-2.jpg

…

• 逐张用 Markdown 图片语法 ![结果图N](url) 渲染，不要只给第一张
• 每张都给出可点击的原始链接（images[].url），并带上 images[].page_range 说明这是第几页
• 顺手带上 task_id，方便之后用 --task 找回
• 一个链接都不要漏

部分成功（退出码 14）时：把已经拿到的图全部渲染出来，再单独列出没出来的那几张和原因，最后提示「可用 --retry 只补失败的部分」。不要因为有几张失败就整单不交付。

7. 异常处理表

用 --json 时：

• ok: true = 未发生失败（含 10 / 13），继续轮询或收尾
• ok: false = 需要处理（3 / 4 / 5 / 8 / 11 / 12 / 14）
• 注意 14 虽然 ok: false，但动作不是「停下」而是「交付已有 + 提示补救」

8. 计费说明（套图金额大，务必先报价）

• 前置条件：账号需有积分（新账号为 0 积分）
• 计费 = 大纲 5 点 + 每张图 × 20 点
• 张数 = 1 张封面 + ceil(内容页数 / --grid)
• 所以一套图约 45 ~ 105 点，远高于单张贴图的 20 点
• 失败批次由后端自动退还积分；--retry 只会补失败的部分，不会重扣已成功的
• 同一会话内对同一份内容与同一组参数重复调用会命中幂等：返回同一个 task_id，不重复扣点

因此：必须先 --dry-run 报出预估消耗，用户确认后再实跑。

python scripts/tietu.py --mode set --topic "..." --count 4 --grid 2 --dry-run

报价时顺手告诉用户：--grid 调大可以省钱（例如 --grid 2 把 2 页拼成一张，张数大约减半）。

9. 禁止事项

1. 不要把「进行中」说成「失败」 —— 退出码 10 / 13 一律继续轮询；套图更慢，容易误判，尤其注意
2. 不要把「部分成功」当失败 —— 退出码 14 要交付已有的图，不是整单放弃
3. 不要只渲染第一张 —— 套图必须逐张渲染全部图片
4. 不要回复「无法查询任务状态」这类话；状态一定能从 --task <id> 查到
5. 不要一次调用阻塞到出图；创建与轮询分开，单次 ≤90s
6. 不要在未确认的情况下扣点 —— 套图金额大，先 --dry-run 报价
7. 不要向用户索要或展示 openid；身份全部由服务端从 API Key 推导
8. 输出链接时前后要留空格；URL 紧贴中文标点（如「，」「（」）会被 Markdown 当成链接的一部分，导致链接失效

更多接口细节与错误码，见 references/api.md。