通过 API 将视频发送到 TikTok 创作者的草稿
TikTok 的 API 通过上传流程把视频发送到创作者的草稿:Content Posting API 的 /v2/post/publish/inbox/video/init/ 在 video.upload 权限范围下上传视频,TikTok 随后向创作者的收件箱发送通知,让其在应用内编辑并发布。API for Business 也能做到同样的事,使用 /business/video/publish/ 上的 upload_to_draft,或在照片帖子上使用 is_draft。
easyCoexistence 可通过 publish_tiktok_post 从 Claude、ChatGPT 或您自己的平台发布 TikTok 视频和照片帖子,可立即发布,也可定时至 90 天后;排队中的帖子会显示在「帖子」页面,直至发出。
TikTok 定义的权限范围:将内容以草稿形式分享到创作者账户,供其在 TikTok 中继续编辑和发布。
任意 24 小时内 Content Posting API 允许的待处理分享数量上限,TikTok 设定此限制以减少垃圾信息。
状态接口 /business/publish/status/ 会在草稿已上传且 TikTok 已通知创作者收件箱后报告状态。
每个用户访问令牌可向 Content Posting API 的上传端点发送的请求数。
当 /business/video/publish/ 上的 upload_to_draft 为 true 时,post_info 其他字段的处理方式。
草稿与直接发布有何不同?
区别在于谁来点击发布。直接发布在 TikTok 处理完成后即上线;草稿则进入创作者的 TikTok 收件箱,只有创作者打开、按需编辑并发布后才会上线。两个 TikTok 发布 API 都体现了这一区别:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Content Posting API 如何上传草稿?
向 https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ 发送 POST 请求,需附带持有 video.upload 的用户访问令牌和 source_info 对象。PULL_FROM_URL 让 TikTok 从应用已验证的域名或 URL 前缀拉取视频;FILE_UPLOAD 会返回 upload_url,文件随后通过 PUT 请求分块发送至该地址。返回的 publish_id 用于 /v2/post/publish/status/fetch/。照片使用 /v2/post/publish/content/init/,并将 post_mode 设为 MEDIA_UPLOAD。TikTok 要求应用提示用户打开收件箱通知,以便在 TikTok 中继续编辑:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Content Posting API 草稿适用哪些限制?
TikTok 在上传参考文档中列出以下限制,适用时均由 init 调用返回:
- 待处理草稿:任意 24 小时内最多 5 个待处理分享;超出后返回
spam_risk_too_many_pending_share,HTTP 403。 - 请求:每个用户访问令牌每分钟 6 次,超出后返回
rate_limit_exceeded,HTTP 429。 - 权限范围:缺少 video.upload 的令牌返回
scope_not_authorized,HTTP 401。 - 媒体:应用未验证的域名或前缀上的
PULL_FROM_URL返回url_ownership_unverified,HTTP 403。
API for Business 如何上传草稿?
通过其发布端点,并在 post_info 中多设置一个字段。在 /business/video/publish/ 上,将 upload_to_draft 设为 true 即以草稿形式发送视频,TikTok 会忽略 post_info 中的其他字段;在 /business/photo/publish/ 上,is_draft 只保留标题和文案。两者都需要账户的令牌具有 video.upload,可在 /tt_user/token_info/get/ 中查看;若缺少该权限,账户所有者需重新授权应用以批准草稿上传。媒体仍须位于已验证的 URL 上,状态显示为 SEND_TO_USER_INBOX,创作者通过收件箱通知找到草稿:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'创作者如何处理草稿?
在 TikTok 中完成。收件箱通知会在 TikTok 编辑器中打开已上传的视频或照片,创作者可在其中审阅、编辑并发布。在 Content Posting API 中,创作者从草稿发布后,状态会从 SEND_TO_USER_INBOX 变为 PUBLISH_COMPLETE;TikTok 还指出,一份草稿可以产生多条帖子。
easyCoexistence 会发送草稿吗?
不会:publish_tiktok_post 直接发布。它调用 /business/video/publish/ 或 /business/photo/publish/ 时不带 upload_to_draft 或 is_draft,因此帖子在 TikTok 处理完成后即上线。若要留出审核时间,可用 scheduled_at 定时,最早 1 分钟、最晚 90 天后:帖子会在「帖子」页面的「即将发布」下等待;update_scheduled_post 可修改其时间、文案,或照片帖子的标题;cancel_scheduled_post 则可在发出前取消。
常见错误
- 用 video.publish 发送草稿:草稿需要 video.upload,TikTok 将该权限范围描述为把内容作为草稿分享。
- 通过 API for Business 为视频草稿设置文案:当 upload_to_draft 为 true 时,TikTok 会忽略 post_info 的其余字段。
- 上传草稿的速度超过创作者发布的速度:Content Posting API 在 24 小时内达到 5 个待处理分享后会停止,并返回 spam_risk_too_many_pending_share。
- 没有告知用户收件箱的位置:TikTok 要求应用提示用户打开收件箱通知,以完成发布。
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费。
常见问题
TikTok API 能把视频保存为草稿吗?
可以。上传流程会把视频放入创作者的 TikTok 收件箱,由创作者编辑并发布;令牌需要 video.upload 权限范围。
通过 API 发送的草稿会出现在哪里?
在 TikTok 应用中,位于收件箱通知之后。通知会在 TikTok 编辑器中打开视频,供创作者完成发布。
TikTok 草稿能保留我的文案吗?
在 API for Business 上,照片草稿会保留标题和文案,视频草稿则会舍弃 post_info 的其他字段。
一份 TikTok 草稿能发布多条帖子吗?
可以。TikTok 指出,一份草稿可以产生多条帖子;在 Content Posting API 中,创作者从草稿发布后,状态会变为 PUBLISH_COMPLETE。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间