Seedance 動画を取得する
GET /v1/videos/ を使って、CometAPI 上の Seedance 動画タスクを id でポーリングします。Seedance 1.0 Pro、1.5 Pro、2.0 の各タスクに対応しています。現在の status、progress、およびタスクが completed に達した後の署名付き video_url を返します。
id は、どの Seedance モデルがタスクを生成したかに関係なく、作成時の呼び出しで返された値です。
レスポンス本文は動画タスクオブジェクトそのものです。トップレベルの status、progress、video_url を確認してください。
ステータスマシン
API は小文字の status 文字列を返します。queued と in_progress は非終端で、completed、failed、error は終端です。終端に達すると、タスクはそれ以上変化しません。
ポーリング間隔
10〜20秒ごとにポーリングしてください。ほとんどのジョブは、model、duration、size に応じて 1〜3 分以内に完了します。確認すべきフィールド
status— ポーリングループの停止条件を決めます。progress— UI に表示できる 0〜100 の整数です。video_url— 署名付きダウンロード URL で、completedレスポンスに含まれます。Seedance のダウンロードでは、別の/v1/videos/{id}/contentルートではなく、この URL を直接使用します。署名には有効期限があるため、期限が切れる前にファイルをダウンロードするか再ホストしてください。completed_at— プラットフォームが返すオプションの Unix タイムスタンプです。ポーリングの停止条件には使わず、代わりにstatusを使用してください。model— タスク作成時に使用された Seedance model id をそのまま返します。
一般的なエラー
- HTTP
400でmessage: "task_not_exist"が返る場合、idが不明であることを意味します。POST/v1/videosの成功レスポンスからidを取得していること、およびその値をそのまま使用していることを確認してください。 - HTTP
401は、bearer token がないか無効であることを意味します。リクエストヘッダーがAuthorization: Bearer $COMETAPI_KEYになっていることを確認してください。
承認
Bearer token authentication. Use your CometAPI key.
パスパラメータ
Task id returned by POST /v1/videos.
レスポンス
Current Seedance video task state.
Task id.
Object type, always video.
Model id that generated the task.
Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.
queued, in_progress, completed, failed, error Completion percentage.
0 <= x <= 100Task creation time as a Unix timestamp in seconds.
Signed download URL for the finished video. Present on completed responses. Seedance downloads use this URL directly instead of a separate /v1/videos/{id}/content route. The signature is time-limited, so download or re-upload the file to your own storage soon after you receive it.
Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.