一句话回答:抖音图文自动发布,核心是三个数:标题不超过 20 个字,正文不超过 1000 字,一次最多 35 张图(jpg/png/bmp/webp/tif)。话题没有单独的入口,直接以
#词的形式写进正文。用 PublishPort 的话,一条ppcli douyin publish-image命令就能带着这些参数发出去,先加--draft存成草稿再看效果最稳。
你在小红书发了一组 9 张图的探店笔记,想顺手搬到抖音,结果在抖音创作者中心找了半天入口,标题填了 28 个字被拦下,正文里的话题又得一个个手点选。图文这个形态,抖音和小红书长得像,规则却不一样,最先卡住人的往往就是字数。
先把命令放前面,下面再解释每个参数为什么这样写。
先看命令:一条发布一组图
ppcli douyin publish-image --title "周末探店三家咖啡馆" \
--file note.txt \
--images ./1.jpg,./2.jpg,./3.jpg \
--topics 探店,咖啡 \
--draft
几个参数的含义:
--title:作品标题,最多 20 字,超了命令会直接报错,不会替你截断。--file:正文放在本机一个 UTF-8 文本文件里读取,最多 1000 字。短正文也可以直接写成位置参数"正文内容",两种方式只能选一个。--images:图片路径,逗号分隔,最多 35 张,支持 jpg、png、bmp、webp、tif。--topics:话题,逗号分隔,不用带#。命令会把它们拼成#探店 #咖啡追加到正文末尾,抖音发布时自己识别成话题。--draft:只存草稿,不发布。确认排版没问题,再去掉这个参数正式发布。
可选参数里值得一提的有两个:--visibility(public / friends / private)控制可见范围;--ai-generated 用来声明内容由 AI 生成,下文边界一节会再说。具体参数以 ppcli douyin publish-image --help 为准,命令行会持续迭代。
抖音的“图文”其实有两种,别搞混
这是搜索时最容易踩的一个坑。抖音现在的图文类内容有两个形态:
| 图文(图集) | 长图文(文章) | |
|---|---|---|
| 形态 | 多张图片轮播,配标题和短正文 | 以文字为主的长文,中间插配图 |
| 上限 | 标题 20 字、正文 1000 字、35 张图 | 据科技日报报道,最多 8000 字、30 张配图 |
| 入口 | 创作者中心的图文发布页 | 创作者中心 PC 端「高清发布 - 发布文章」 |
| 适合 | 探店、教程步骤、穿搭、读书摘录 | 深度观点、年终总结、新闻长文 |
publish-image 能发吗 |
能 | 不能,这条命令只管图集 |
所以如果你的稿子是 3000 字的公众号长文,别指望塞进图文里,正文 1000 字的上限会直接把它拦下。长文要么拆成多张图卡片,要么走长图文的网页入口手动发。
为什么图文是用界面自动化,而不是调接口
抖音视频有一条走创作者中心后台的发布通道,但图文不行。ppcli 源码里的注释写得很直接:字节的安全组件会拦截后台窗口里对图片上传和 create_v2 接口的直接请求,真机测试时图片上传申请会报 Failed to fetch。所以 publish-image 的做法是:打开创作者中心的图文上传页,把图片塞进文件选择框,填标题、填正文,最后点「发布」,由页面自己带上签名把请求发出去。
这件事对你有两个实际影响:
- 运行时会拉起一个前台窗口,别在它跑的这几十秒里去操作那个窗口。
- 要先在 creator.douyin.com 登录过。如果登录态过期被跳走,命令会明确报“被重定向离开创作者中心”,而不是假装成功。
这类自动化的另一面是页面改版会让它失效。命令里对“标题没填进去”“正文校验不一致”“找不到发布按钮”都做了报错,并保存调试截图到 /tmp,宁可报错也不静默发出一条残缺的内容。
把这件事交给 AI:从选图到发布
一组图文真正耗时间的是前面:选图、写 20 字以内的标题、挑话题,而不是最后那一下点击。PublishPort 的思路是让 AI 用你自己电脑上已登录的抖音账号完成这些步骤,登录态留在本机。装好客户端、在创作者中心登录一次后,你可以直接对 AI 说“把这组图发成抖音图文,标题控制在 20 字内,先存草稿”,它会自己读 --help,拼出上面那条命令。
我自己的做法是固定一个顺序:
- 让 AI 先写标题,并且要求它自己数字数。中文标题 20 字很短,“周末探店三家咖啡馆,第二家我想再去一次”已经 19 个字了。
- 先用
--draft存草稿,去创作者中心的草稿箱看一眼图片顺序和封面。 - 没问题再不带
--draft重发一遍。
多这一步看起来慢,但图片顺序错了或者话题挂错,发出去再改的成本比先看草稿高得多。同一组内容想发到小红书,可以参考小红书批量发布里对笔记字数和图片的限制,两个平台的标题上限不一样,同一个标题直接复制过去多半会超。
话题怎么选:别塞满
--topics 支持多个,但不是越多越好。图文的正文本来就只有 1000 字,话题是占字数的,每个 #词 也算在里面。我一般只放 2 到 3 个:一个大类话题(比如 #探店),一个具体场景(比如 #咖啡),再有活动就加一个。想知道哪些话题当下有热度,ppcli 里有只读的 douyin hashtag 命令可以按关键词搜或者拉热点词,发布前让 AI 先查一遍,比凭感觉编话题靠谱。
边界与注意
- 图文发布依赖页面结构。抖音改版后命令可能暂时失效,遇到报错先看截图,别直接重试十次。
- AI 生成的内容要声明。如果配图或文案是 AI 生成的,加上
--ai-generated,命令会在发布页勾选对应声明;设置失败时会停止提交,不会悄悄漏掉。国家网信办等四部门的《人工智能生成合成内容标识办法》自 2025 年 9 月 1 日起施行,细节见AI 生成内容声明怎么设置。 - 别把一组图原样刷屏。同一批图每天发十遍,平台怎么判断是它的事,谁也不能保证不被限流。图文的价值在于一次内容多平台各自改写,而不是复制粘贴。批量到多个平台的完整做法见抖音批量发布。
- 只发你有权使用的图片。别拿别人的摄影作品当配图。
发布前检查清单
- 标题数过字数,不超过 20 个
- 正文加上话题不超过 1000 字
- 图片不超过 35 张,格式在 jpg/png/bmp/webp/tif 之内
- 第一次先用
--draft,在草稿箱确认顺序 - AI 参与生成的内容,已加
--ai-generated - 发布后打开作品页确认,不是只看命令没报错
常见问题 / FAQ
抖音图文一次最多能传几张图?
自动发布命令里的上限是 35 张,支持 jpg、png、bmp、webp、tif。长图文(文章)的配图上限是另一套规则,据科技日报报道是 30 张,不要混用。
抖音图文标题最多多少字?
用这条命令发布时是 20 字,超出会直接报错。视频的标题上限是 30 字,两者不一样。
抖音图文的话题怎么添加?
话题没有单独入口,在正文里写 #话题词 即可,抖音会自己识别成话题。用 --topics 探店,咖啡 的话,命令会替你拼好追加到正文后面,不用手写 #。
抖音电脑端能发图文吗?
创作者中心网页版有图文上传页,publish-image 就是在这个页面上做的自动化。长图文的入口在 PC 端「高清发布 - 发布文章」,是另一个功能。
抖音图文能定时发布吗?
publish-image 没有定时参数,只有“立即发布”和“存草稿”。需要定时发布的话,视频的 publish 命令支持 --schedule,提前 2 小时到 14 天之间都可以,图文这边需要自己在草稿里再处理。
发了图文之后评论私信怎么接?
发布只是第一步。评论和私信可以让 AI 一并接住,见抖音私信自动回复。
本文的命令以 PublishPort 文档与 --help 输出为准;上游自动化能力来自开源项目 OpenCLI。
