Seedance 2.0 動画を取得（Platform 形式）

Platform Video Generations API を使用して Seedance 2.0 動画タスクを取得します。

Task ID を使用してステータスと結果を取得します。デフォルトでは Platform のタスクオブジェクトを返します。raw=true は Volcengine Ark のネイティブタスク構造を直接返し、show_raw=true は同じネイティブ構造を Platform ラッパーに含め、show_usage=true は Platform が整理した使用量情報を返します。動画と終了フレームの URL には有効期限がある場合があるため、速やかにダウンロードまたは保存してください。

Volcengine Ark のタスク構造を直接取得する場合は、ネイティブ形式の取得 APIを参照してください。

ネイティブタスクデータは、標準版 Seedance 2.0 の 4k 解像度とタスクの priority をサポートします。Fast は 480p/720p のみをサポートします。

GET/v1/video/generations/{task_id}

作成 API が返した Task ID を使用して Seedance 2.0 動画タスクを取得します。タスクが completed または failed になったらポーリングを停止してください。

30～60 秒ごとに取得することを推奨します。完了した動画の URL には有効期限がある場合があるため、速やかにダウンロードして保存してください。

認証

bearerAuth

認証Bearer <token>

Authorization Header に Bearer your-api-key を指定します。

指定位置: header

パスパラメーター

task_id*string

動画タスク作成時に返された Task ID です。

長さ1 <= length

クエリパラメーター

raw?boolean

true の場合、トラブルシューティングのために上流の生タスクデータを直接返します。

show_raw?boolean

true の場合、互換ラッパーレスポンスの data.data フィールドに上流の生タスクデータを含めます。

show_usage?boolean

true かつタスクが成功した場合、互換ラッパーレスポンスの data.usage フィールドに使用量情報を含めます。

レスポンスボディ

`application/json`

curl -X GET "https://example.com/v1/video/generations/cgt-20260330164007-wnc8k"

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

Seedance 2.0 ネイティブタスク構造のリファレンスraw と show_raw が使用する Volcengine Ark のタスク取得構造を確認します。

Seedance 2.0 動画を取得（Platform 形式）

認証

パスパラメーター

クエリパラメーター

レスポンスボディ

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`