·
🖼️ 用 AI 助手或 API 发书、发长文,图片一起上传 | 10.16
书籍和长文都能通过 MCP 或 API 带图发布,正文里的图表原样出现在文中。
Pickful 社区朋友们,
用 AI 助手(Claude、Codex 等任何支持 MCP 的工具)或 REST API 发内容的朋友,反馈最多的一件事是:文字能自动发,图却得另想办法。书籍只能在网页上传,长文只能带一张封面,正文里的图表、截图,只能另找图床再贴链接。今天这两件事一起解决了。
💡 先说一句:下面提到的打包、上传、参数这些中间细节,AI 助手会自己查看工具说明,自动完成。你只要把需求说清楚就好,比如「把这个文件夹里的书稿连同插图发成一本书,定价 10 USDC,先存草稿」。
📚 书籍:一个 ZIP,整本书连图带封面
现在可以直接用 AI 助手或 API 发书了:
-
打包上传:把书稿
book.md和images/文件夹打成一个 ZIP,根目录放一张cover.png就是封面 -
自动排版:每个一级标题
# 章名是一章,图片按引用位置放进对应章节 - 容量够大:每本书最多 200 张图,ZIP 不超过 50MB
-
先审再发:默认建成草稿,用
get_book_status核对章节数、图片和封面,确认无误再publish_book;也可以用published_at定时上架 - 定价与署名:可设作者名和 USDC 价格,读者付款直达作者钱包
-
改版方便:
update_book传一个新的 ZIP,整本书重新解析,章节和图片一起更新
相关工具:create_book_upload、create_book、update_book、get_book_status、publish_book。
✍️ 长文:正文配图
写稿时照常用 Markdown,在想放图的位置写一行 ,然后任选一种方式交图:
| 方式 | 适合 | 做法 |
|---|---|---|
| 直接附图 | 图少(一两张) |
create_post 时多传一个 assets,图片用 base64 |
| 打包上传 | 图多 |
post.md 加 images/ 打成 ZIP,先 create_post_upload 传上去,再用 upload_id 发文;根目录的 cover.png 就是封面 |
每篇最多 40 张图,ZIP 不超过 30MB。update_post 同样能补图、换图,只改文字时原来的图照样显示;只传文字和封面的老用法完全不变。
🛡️ 两边共用的几个细节
- 不会发出半成品:正文引用了但没上传的图,直接报错并列出缺哪几张
- 多传的图会提醒:上传了却没用到的图,会在结果里列出来
-
超时重试不重复:网络断了用同一个
upload_id再提交一次,拿回的是已经建好的那本书或那篇文章
单张图 5MB 以内,支持 PNG、JPEG、WebP。
💬 致社区
好的研究离不开图:一张数据图,往往比三段文字更有说服力。希望这次更新让大家把完整的研究,连同每一张图,原样搬上 Pickful。用起来有任何问题,欢迎随时告诉我们。
此功能已在 Web、iOS、Android 三端同步上线,无需更新 App 即可使用。
Pickful Team
10.16
转发此帖子?
与您的关注者分享。
回复