TikTok Content Posting APIで大容量動画を送る前の条件

転送条件と投稿できる長さは別

APIの動画ファイル最大は4 GBです。FILE_UPLOADでは5 MB未満は一括、64 MBを超える場合は複数チャンクを使います。通常のチャンクは5～64 MB、最後のチャンクは128 MBまでで、1～1000チャンクを順番に送ります。初期化で受け付ける最大10分という値だけを、すべてのクリエイターの投稿許可時間とみなせません。

Query Creator Infoで返るmax_video_post_duration_secを確認し、対象クリエイターの上限に収めます。upload_urlは1時間で失効します。PULL_FROM_URLを使うなら、HTTPS、所有確認済みのドメインまたはURL接頭辞、リダイレクトなし、取得中の継続アクセスという条件があります。

公式API案内には24時間に保留できる共有が最大5件という運用上の制限もあります。ファイル条件と動画時間を満たしても、保留中の投稿を含めた共有数を別に確認してください。

クリエイター情報から転送計画を作る

まずCreator Infoを取得して許される動画時間を確認してください。FILE_UPLOADかPULL_FROM_URLを選び、前者なら64 MBと128 MBの境界を踏まえたチャンク数と順序、後者ならURLの所有確認とアクセス可能時間を決めます。開始前に期限切れのupload_urlを使わないことと、直近24時間の保留中共有が5件に達していないことも確認します。APIの容量条件を満たすだけでは投稿の成立は保証されません。