Skip to main content
GET
cURL
このエンドポイントは、Seedance 動画を作成する で作成したタスクの状態を取得するために使用します。パス内の id は、どの Seedance モデルがタスクを生成したかに関係なく、作成時の呼び出しで返された値です。 レスポンス本文は動画タスクオブジェクトそのものです。トップレベルの statusprogressvideo_url を確認してください。

ステータスマシン

API は小文字の status 文字列を返します。queuedin_progress は非終端で、completedfailederror は終端です。終端に達すると、タスクはそれ以上変化しません。

ポーリング間隔

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 400message: "task_not_exist" が返る場合、id が不明であることを意味します。POST /v1/videos の成功レスポンスから id を取得していること、およびその値をそのまま使用していることを確認してください。
  • HTTP 401 は、bearer token がないか無効であることを意味します。リクエストヘッダーが Authorization: Bearer $COMETAPI_KEY になっていることを確認してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

id
string
必須

Task id returned by POST /v1/videos.

レスポンス

Current Seedance video task state.

id
string
必須

Task id.

object
string
必須

Object type, always video.

model
string
必須

Model id that generated the task.

status
enum<string>
必須

Task status. queued and in_progress are non-terminal. completed, failed, and error are terminal.

利用可能なオプション:
queued,
in_progress,
completed,
failed,
error
progress
integer
必須

Completion percentage.

必須範囲: 0 <= x <= 100
created_at
integer
必須

Task creation time as a Unix timestamp in seconds.

video_url
string | null

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.

completed_at
integer | null

Optional Unix timestamp returned by the platform. Use status, not this field, to decide when polling can stop.