ログイン無料トライアルを開始
easyCoexistence 公式 API

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、または独自のプラットフォームに対応します。

reason

フィールド /business/publish/status/ は、status が FAILED のときのみ返され、frame_rate_check_failed などの値を含みます。

fail_reason

Content Posting API での同じフィールドの名前は、/v2/post/publish/status/fetch/ のレスポンスに含まれます。

1 hour

TikTok が video_pull_failed または photo_pull_failed で投稿を失敗させるまでの、ダウンロードのタイムアウト時間です。

24 hours

spam_risk_too_many_posts の対象となる期間です。TikTok は、その投稿を TikTok モバイルアプリから公開することを推奨しています。

3 hours

多くの場合、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 として返します:

A failed post in /business/publish/status/, from TikTok's example
{
  "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 foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing 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 を渡してください。新しいファイルまたはキャプションが必要な投稿は、代わりに再度予約されます。

Failed posts through MCP
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 に属します。
EasyCoexistence で実現する

失敗は 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 監視

確認日