发一条 Telegram 消息，生成一本带插图的历史 PDF 书

发一条 Telegram 消息，生成一本带插图的历史 PDF 书

一个把发给 Telegram 机器人的历史题目变成带插图 PDF 书的 n8n 工作流。一个小的 OpenAI 模型先检查题目是不是历史或知识概念。一个更大的模型上网研究，写出 5 到 20 个章节，每章带日期和一句画面提示词。Kie.ai 用 Nano Banana Pro 为每章画一张图，APITemplate.io 把各章排成 A4 页面。PDF 存进你的 Google Drive，一张 Google 表格记录这本书和每张图片。

包里有什么

• workflow.json：n8n 导出的工作流，37 个节点，其中四个便签只标出各个阶段。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 作者的表格和标签页 ID 已删掉。五个表格节点改为要 YOUR_SHEET_ID，并按名称 Sheet1 找标签页。
• Kie.ai 请求头原来写的是 Bearer <token>，现在是 Bearer <YOUR_KIE_API_KEY>。APITemplate.io 的请求头现在是 <YOUR_APITEMPLATE_API_KEY>。
• Telegram、OpenAI、Google Sheets 和 Google Drive 的凭据都已删掉，上面作者的账号名也一并去掉，Telegram 节点的 webhook ID 也删了。
• HTML to PDF 里的一处修复：导出时它的请求体丢了两个反斜杠。原来写的是 .replace(/"/g, '\"') 和 .replace(/n/g, '')，结果 HTML 里的双引号都没有转义，页面里的字母 n 也全被删掉。现在写的是 .replace(/"/g, '\\"') 和 .replace(/\n/g, '')，这一步要发出有效的 JSON 就得这样。
• Cloudinary 的占位符 <YOUR_CLOUD_NAME>、YOUR_PRESET_NAME 和 YOUR_FOLDER_NAME 原本就在文件里。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。Telegram 触发器要求 n8n 在一个公开的 https 地址上。
• 一个 Telegram 机器人和它的令牌，从 BotFather 获取。
• 一个能用 gpt-5.1 和 gpt-4.1-mini 的 OpenAI API 密钥。
• 一个有额度的 Kie.ai API 密钥。
• 一个带无签名上传预设的 Cloudinary 账号。
• 一个 APITemplate.io API 密钥。
• 一个用来登录 Sheets 和 Drive 的 Google 账号，以及一张带下面这个标签页的 Google 表格。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 建一张 Google 表格，第一个标签页名为 Sheet1，第 1 行写下面八个表头。复制它的 ID：地址里 /d/ 和 /edit 之间那一长串。
3. 用你机器人的令牌添加 Telegram 凭据，在 Telegram Trigger、Send a text message 和 Send a text message1 里选中它。
4. 添加 OpenAI 凭据，在 OpenAI Chat Model 和 OpenAI Chat Model1 里选中它。
5. 添加 Google Sheets OAuth2 凭据。在 Create Job、Append row in sheet2、Update row in sheet、Update row in sheet1 和 Update row in sheet2 里选中它，并把每个节点里的 YOUR_SHEET_ID 换成表格的 ID。
6. 在 nano-banana-pro 和 nano-banana-pro-result 里，把 Bearer 后面的 <YOUR_KIE_API_KEY> 换成你的 Kie.ai 密钥。尖括号也要去掉。
7. 在 Cloudinary 里建一个无签名上传预设。在 Upload Photo 里，把地址中的 <YOUR_CLOUD_NAME> 换成你的 cloud name，连尖括号一起，再用预设名和一个文件夹名替换 YOUR_PRESET_NAME 和 YOUR_FOLDER_NAME。
8. 在 HTML to PDF 里，把 X-API-KEY 请求头里的 <YOUR_APITEMPLATE_API_KEY> 换成你的密钥，连尖括号一起。地址用的是 APITemplate.io 的美国区域，如果你的账号在别的区域，就把 rest-us 改掉。
9. 添加 Google Drive OAuth2 凭据，在 Upload PDF 里选中它。文件存在“我的云端硬盘”的根目录。
10. 保存，点 Publish。给你的机器人发一个简短的题目，比如 the moon landing。

表格

Sheet1 的第 1 行写这八个表头，拼法和这里一样。一本书占一行，书里的每张图片各占一行：

| 列 | 书的那一行 | 图片的那一行 |
|---|---|---|
| ID | 一个新的 UUID | 一个新的 UUID |
| Parent ID | 空 | 所属那本书的 ID |
| Concept | 分类器改写后的题目 | 空 |
| Type | Briefing Job | Asset Creation |
| Status | Generating...，然后 Completed | Queued、Generating...，然后 Completed |
| Prompt | 空 | 画面提示词 |
| Public Link | 空 | 图片在 Cloudinary 上的地址 |
| PDF Link | PDF 的 Drive 链接 | 空 |

一次运行的过程

1. Telegram Trigger 接收发给机器人的每条消息。发来的是文件时，File Check 回复 Files not supported。
2. 运行在 gpt-4.1-mini 上的 AI Agent1 判断文字是不是历史或教育题目。不是的话，机器人回复一句由模型写的简短拒绝，运行结束。
3. 有效的题目由 Crypto1 生成一个 UUID，Create Job 用改写后的题目加上书的那一行。
4. 运行在带 OpenAI 网页搜索的 gpt-5.1 上的 AI Agent 按时间顺序写出 5 到 20 个章节。每章有标题、日期、一段三四句话的正文，以及一句写明画面里要出现什么文字的提示词。
5. Split Out 和 Crypto 给每章一个自己的 UUID，Append row in sheet2 为它排进一行。
6. Loop Over Items 一次处理一章。nano-banana-pro 请 Kie.ai 生成一张 1K 的 16:9 PNG。Wait 等 30 秒，nano-banana-pro-result 查询任务状态，Switch 按状态分流：还在进行就再等，完成了就继续。
7. download-image 下载图片，Upload Photo 把它传到 Cloudinary，Update row in sheet1 把那一行标为 Completed 并写入地址。
8. 所有章节完成后，Aggregate 和 HTML 为每章做一页：标题、日期徽标、图片、正文段落，以及带这一章 ID 的页脚。
9. HTML to PDF 把页面发给 APITemplate.io 做成 A4 PDF，Download PDF 下载它，Upload PDF 存进 Drive，文件以题目和书的 ID 命名。Update row in sheet2 把书标为 Completed 并写入 Drive 链接。

改变风格

• 哪些题目能通过：AI Agent1 的系统消息。
• 章节的数量、长度和语气：AI Agent 的系统消息。
• 图片：nano-banana-pro 请求体里的 aspect_ratio、resolution 和 output_format。
• 页面设计：HTML 里的 HTML 和 CSS，包括字体和页脚文字。
• 纸张和页边距：HTML to PDF 请求体里的 settings。
• PDF 存到哪里：Upload PDF 的云端硬盘和文件夹。

注意事项

• PDF 从不发回 Telegram。成功时运行在表格那一步结束，提问的人收不到任何消息。如果要让他们拿到，就在 Update row in sheet2 后面加一个 Telegram 发送节点，带上 PDF Link。
• 谁都能用：任何找到这个机器人的人发消息，它都会回应，每本书都花 OpenAI、Kie.ai 和 APITemplate.io 的额度。在 Telegram Trigger 里把 Restrict to User IDs 设成你自己的 ID。
• 停用的模型：OpenAI 将于 2027 年 1 月 14 日停用 gpt-4.1-mini，替代模型是 gpt-6-luna，并于 2027 年 4 月 1 日停用 gpt-5.1，替代模型是 gpt-6-sol。在这些日期之前改掉 OpenAI Chat Model1 和 OpenAI Chat Model。
• 一张图失败会让整本书卡住：Switch 的 fail 状态没有去处，所以循环停在那里。不会生成 PDF，各行一直停在 Generating...，也没有人收到通知。
• 其他消息：只有文件会被拒绝。照片、贴纸或语音消息到达 AI Agent1 时没有文字，运行会在那里失败，也不会回复。
• 没有风格参考图：AI Agent 的提示词说画风由一张外部参考图决定，但 nano-banana-pro 并没有发送参考图，所以每张图的风格由模型决定。想要统一的画风，Kie.ai 的 image_input 最多能接收八张参考图。
• 公开的文件：每张图片都在一个公开的 Cloudinary 地址上，APITemplate.io 把 PDF 存在它自己的 CDN 上，除非你设了有效期，否则不会过期。Drive 链接只对能在你的 Drive 里看到这个文件的人有效。
• 费用：Kie.ai 每张图都收费，每章一张。OpenAI 两个智能体都收费，网页搜索另算。APITemplate.io 每份 PDF 都计入你的套餐。
• 时间：每张图至少要等 30 秒，所以一本长书要跑十分钟以上。
• 你的数据：题目和章节发给 OpenAI，画面提示词发给 Kie.ai，页面发给 APITemplate.io。
• 凭据：JSON 里没有任何凭据，也没有作者表格里的任何东西。