TikTok の投稿失敗:spam_risk_too_many_posts、picture_size_check_failed などの失敗理由
TikTok は投稿の失敗理由を、企業向け API のステータスエンドポイント(/business/publish/status/)では reason で、Content Posting API では fail_reason で返します。picture_size_check_failed のようなチェック系の失敗は、ファイルが形式ルールに違反しているため、ファイルの変更が必要です。video_pull_failed は、TikTok が 1 時間以内に動画をダウンロードできなかったことを意味します。spam_risk_too_many_posts は、24 時間以内の API 投稿が多すぎることを意味します。internal とマークされた失敗は、そのまま再試行できます。
easyCoexistence は、TikTok が公開または失敗させるまで、発行した各 TikTok 投稿を追跡し、Claude、ChatGPT、または独自のプラットフォームに対応します。
フィールド /business/publish/status/ は、status が FAILED のときのみ返され、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 は、その投稿を TikTok モバイルアプリから公開することを推奨しています。
多くの場合、easyCoexistence はあるチャネルで投稿が失敗したオーナーにメールを送り、その投稿は「要対応」の下で待機します。
TikTok は投稿の失敗理由をどこで報告しますか?
公開リクエストは、タスクを開始するだけです。その code 0 は、TikTok が受け付けたことを意味し、投稿が必ず公開されることを意味するわけではありません。GET /business/publish/status/ は、status が FAILED のときに reason を返します。公開に関する Webhook を購読しているアプリは、同じ reason と publish_id を含む post.publish.failed イベントを受け取ります。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 の投稿公開イベントのリファレンスに記載された理由を、それぞれが指し示す対処法と並べて示します。最初の 4 つは、ファイルのダウンロード後に 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 を返し、ユーザートークンごとに 1 分あたり 30 リクエストまで許可し、spam_risk_user_banned_from_posting と spam_risk_text については再試行しないよう助言を加えます。いくつかの拒否は、代わりに init 呼び出しで HTTP 403 として返されます:
spam_risk_too_many_posts:クリエイターが API の 1 日あたりの投稿上限に達しました。unaudited_client_can_only_post_to_private_accounts:審査を受けていないアプリが、公開アカウント向けに投稿しようとしました。url_ownership_unverified:アプリが検証していないドメインまたはプレフィックスからのPULL_FROM_URLです。privacy_level_option_mismatch:privacy_levelが欠けているか、クリエイターの選択肢の範囲外です。reached_active_user_cap:アプリが、投稿を行うアクティブユーザーの 1 日の上限に達しました。
TikTok に届く前に失敗するのはどのようなケースですか?
easyCoexistence が先に検出し、TikTok の理由ではなく独自のメッセージで伝えるケースです。予約投稿のメディアは予約時にコピーされ、そのとき、Web ページを返すリンク、404、種類の違うリンク、画像で 30 MB または動画で 1 GB を超えるファイルは拒否されます。拡張子が .png、.gif、.bmp、.heic、.avif、.svg で終わる写真のリンクは、何も送信する前に拒否されます。投稿時に再接続が必要なチャネルは reconnect として失敗し、チャネルを削除すると、そのチャネルの予約投稿はキャンセルされます。
easyCoexistence は、失敗した TikTok 投稿をどのように報告しますか?
投稿キューを通じて報告します。キューは、公開リクエストの後で各 TikTok 投稿を追跡し、PUBLISH_COMPLETE になるまで約 20 秒ごとに /business/publish/status/ を確認します。FAILED のステータスは投稿を失敗させ、そのメッセージには括弧内に TikTok の理由が示されます(例:frame_rate_check_failed)。各失敗には failure_kind が付与されます:
- refused:TikTok が FAILED ステータスとその理由で拒否しました。
- uncertain:公開リクエストに明確な応答がなかったか、2 時間以内に TikTok から確認が得られなかったため、投稿がすでに公開されている可能性があります(
may_be_published)。 - reconnect:TikTok がアカウントのトークンを拒否したため、新しくサインインする必要があります。
- internal:easyCoexistence が投稿を引き渡す前に失敗したため、何も送信されていません。
失敗した投稿は、どのように見つけて再試行しますか?
オーナーは、バックグラウンドで見つかった失敗について、チャネルごとに 3 時間に最大 1 通のメールを受け取ります。プラットフォームのイベント 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 で fail_reason を探すこと。そのステータスエンドポイントはフィールドを reason と呼びます。fail_reason は Content Posting API に属します。
失敗は TikTok の理由とともに、メール、投稿画面、post.failed イベントで届き、再試行の準備が整います。接続 1 件あたり月額 US$ 9 から、接続を増やすほど US$ 0.75 まで下がります。最初の 3 日間は無料です。
よくある質問
TikTok で picture_size_check_failed とはどういう意味ですか?
TikTok は投稿をダウンロードし、画像の高さと幅が最小の 360 ピクセルを下回っていることを確認しました。より大きいファイルが必要です。TikTok はこの失敗を再試行不可としてマークしています。
video_pull_failed とは何ですか?
TikTok は URL から動画をダウンロードできなかったか、1 時間のタイムアウト内にダウンロードできませんでした。URL が公開されており、帯域が制限されていないことを確認してから、再試行してください。
spam_risk_too_many_posts はどのくらい続きますか?
TikTok は直近 24 時間に API 経由で行われた投稿を数えます。1 アカウントあたり 1 日およそ 15 件です。その間は、TikTok モバイルアプリから投稿することを推奨しています。
easyCoexistence は失敗した TikTok 投稿を自動で再試行しますか?
いいえ。TikTok が FAILED と報告した後は、投稿は「要対応」の下で待機し、オーナーにメールが送られます。「再試行」ボタンまたは retry_scheduled_post で再送信します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日