·
🖼️ 用 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
Repost this post?
Share with your followers.
Reply