TikTok 发布失败:spam_risk_too_many_posts、picture_size_check_failed 等失败原因
TikTok 在 API for Business 的状态端点中通过 reason 字段说明帖子失败的原因,在 Content Posting API 中则通过 fail_reason 字段。picture_size_check_failed 等检查失败表示文件违反了格式规则,需要更换文件;video_pull_failed 表示 TikTok 无法在一小时内下载文件;spam_risk_too_many_posts 表示 24 小时内通过 API 发布的帖子过多。标记为 internal 的失败可直接重试。
easyCoexistence 会跟踪其发布的每个 TikTok 帖子,直至 TikTok 完成或使其失败,适用于 Claude、ChatGPT 或您自己的平台。
仅当 status 为 FAILED 时,/business/publish/status/ 才返回该字段,其值如 frame_rate_check_failed。
Content Posting API 中同一字段的名称,见 /v2/post/publish/status/fetch/ 的响应。
下载超时时间,超时后 TikTok 会以 video_pull_failed 或 photo_pull_failed 使帖子失败。
spam_risk_too_many_posts 的时间窗口;TikTok 建议改为通过其移动应用发布该帖子。
最常见的情况是 easyCoexistence 就某一渠道的失败帖子向所有者发送邮件;该帖子会在“需要注意”下等待。
TikTok 在哪里报告帖子发布失败的原因?
发布调用仅启动任务,其返回的代码 0 表示 TikTok 已接收,并不代表帖子会上线。随后,GET /business/publish/status/ 会返回状态 FAILED 及 reason;订阅了发布相关 Webhook 的应用会收到 post.publish.failed 事件,其中包含相同的 reason 和 publish_id。Content Posting API 的 /v2/post/publish/status/fetch/ 则将该字段返回为 fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}每种失败原因的含义是什么,应如何修复?
以下为 TikTok 帖子发布事件参考中对各失败原因的说明,并列出各自对应的修复方法。前四项是 TikTok 下载文件后执行的检查,均标记为不可重试。TikTok 的失败表仍将 duration_check_failed 的最长视频时长定为 60 秒,而视频接口文档为 600 秒,或以账户自身的 max_video_post_duration_sec 为准:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
哪些失败可以重试?
由下载过程或 TikTok 自身引起的失败可以重试。其余失败需要更换文件或文案、暂停,或无需处理:
- 原样重试:internal,以及 URL 公开且速度足够快后的
video_pull_failed或photo_pull_failed。 - 更换文件后重试:
file_format_check_failed、duration_check_failed、frame_rate_check_failed和picture_size_check_failed。 - 更换文案后重试:
spam_risk_text。 - 等待,或改为通过 TikTok 应用发布:
spam_risk_too_many_posts。 - 请勿重试:按 TikTok 的建议,
auth_removed和spam_risk,或spam_risk_user_banned_from_posting。
Content Posting API 的失败有何不同?
原因相同,但字段和端点不同,并且有些拒绝发生在处理开始之前。/v2/post/publish/status/fetch/ 返回 fail_reason,每个用户访问令牌每分钟允许 30 次请求,并为 spam_risk_user_banned_from_posting 和 spam_risk_text 提供请勿重试的建议。部分拒绝改在 init 调用时返回,HTTP 状态码为 403:
spam_risk_too_many_posts:创作者已达到 API 的每日发帖上限。unaudited_client_can_only_post_to_private_accounts:未经审核的应用尝试为公开账户发帖。url_ownership_unverified:使用PULL_FROM_URL时,来源域名或前缀未经该应用验证。privacy_level_option_mismatch:privacy_level缺失,或不在创作者可选范围内。reached_active_user_cap:应用已达到活跃发布用户的每日配额。
哪些失败发生在 TikTok 接收帖子之前?
easyCoexistence 可以先行拦截这些情况,并显示其自身的消息,而非 TikTok 的原因。定时帖子的媒体在排期时即被复制;若链接返回的是网页、404 或错误类型,或图片超过 30 MB、视频超过 1 GB,则会在此时被拒绝。以 .png、.gif、.bmp、.heic、.avif 或 .svg 结尾的图片链接会在发送前被拒绝;发帖时需要重新连接的渠道会以 reconnect 原因失败;删除某个渠道会取消其定时帖子。
easyCoexistence 如何报告失败的 TikTok 帖子?
由其发布队列完成。发布调用后,该队列会跟踪每个 TikTok 帖子,约每 20 秒检查一次 /business/publish/status/,直至 PUBLISH_COMPLETE。状态为 FAILED 时帖子即失败,错误信息的括号内写明 TikTok 的原因,例如 frame_rate_check_failed,并且每次失败都附带一个 failure_kind:
- refused:TikTok 明确拒绝,例如状态为 FAILED 及其原因。
- uncertain:发布调用未得到明确回应,或 TikTok 在 2 小时内未予确认,因此帖子可能已上线(
may_be_published)。 - reconnect:TikTok 拒绝了该账户的令牌,需要重新登录。
- internal:easyCoexistence 在移交帖子之前已失败,因此未发出任何内容。
如何查找并重试失败的帖子?
后台发现的失败会以邮件通知所有者,每个渠道至多每 3 小时一封;平台的事件 URL 会收到 post.failed。帖子会显示在“帖子”页面的“需要注意”下,并提供重试、重新连接和忽略按钮;list_scheduled_posts 会将其返回给 Claude 或 ChatGPT。retry_scheduled_post 会立即重新发布该帖子,所用文件保留至失败后 7 天;当 may_be_published 为 true 时,请先检查 list_social_posts,只有在帖子确实缺失时才传入 confirm 参数。需要更换文件或文案的帖子则会改为重新排期。
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }
retry_scheduled_post { "post_id": "<POST_ID>" }
// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }常见错误
- 用同一文件重试检查类失败。TikTok 将格式、时长、帧率和图片尺寸失败标记为不可重试。
- 立即重试 spam_risk_too_many_posts。TikTok 会统计 24 小时内通过 API 发布的帖子数量,并建议改用移动应用发帖。
- 未经查看就重试标记为 may_be_published 的帖子。TikTok 可能已发布该帖子;请检查账户最新帖子,否则会发布两次。
- 在 API for Business 中查找 fail_reason。其状态端点的字段名为 reason;fail_reason 属于 Content Posting API。
失败时,TikTok 的原因会通过邮件、帖子页面及 post.failed 事件送达,并可随时重试。每个连接每月 US$ 9 降至 US$ 0.75,连接越多越便宜,前 3 天免费。
常见问题
TikTok 的 picture_size_check_failed 是什么意思?
TikTok 下载了该帖子,发现图片的高度或宽度低于 360 像素的最低要求。需要更大的文件,因为 TikTok 将此失败标记为不可重试。
什么是 video_pull_failed?
TikTok 无法从其 URL 下载视频,或未能在一小时的超时时间内完成下载。请检查 URL 是否公开且未限制带宽,然后重试。
spam_risk_too_many_posts 会持续多久?
TikTok 统计过去 24 小时内通过 API 发布的帖子,每个账户约为每天 15 条,期间建议改用 TikTok 移动应用发帖。
easyCoexistence 会自动重试失败的 TikTok 帖子吗?
TikTok 报告 FAILED 后不会自动重试。帖子会在“需要注意”下等待,所有者会收到邮件;点击重试或调用 retry_scheduled_post 可将其再次发送。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间