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

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

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

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

ネイティブデータの draft と draft_task_id で、Draft サンプルと正式動画を区別できます。一連の手順は Draft サンプル動画生成ガイドをご覧ください。

GET/v1/video/generations/{task_id}

作成 API が返した Task ID を使用して Seedance 2.5 動画タスクを取得します。デフォルトでは code、message、data で構成される Platform 互換ラッパーを返します。タスクが succeeded、completed、failed のいずれかになったらポーリングを停止してください。

raw=true を指定すると Volcengine Ark のネイティブタスク構造を直接取得できます。show_raw=true は互換ラッパーの data.data に同じネイティブ構造を含め、show_usage=true は成功したタスクの data.usage に Platform が整理した使用量情報を含めます。

認証

bearerAuth

認証Bearer <token>

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

指定位置: header

パスパラメーター

task_id*string

Seedance 2.5 タスクの作成時に返された Task ID です。

長さ1 <= length

クエリパラメーター

raw?boolean

true の場合、保存された上流の生タスクデータを直接返します。

show_raw?boolean

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

show_usage?boolean

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

レスポンスボディ

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_xxxxx"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxx",
    "status": "succeeded",
    "url": "https://example.com/generated-video.mov",
    "format": "mov",
    "metadata": null,
    "error": null
  }
}

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

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

認証

パスパラメーター

クエリパラメーター

レスポンスボディ

200application/json

400application/json

401application/json

402application/json

404

429application/json

500application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`