Seedance 2.0 動画を作成（Platform 形式）

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

テキスト、画像、動画、音声入力に対応し、テキストからの動画生成、開始フレームまたは開始・終了フレームの制御、参照素材を使用した生成に利用できます。

Volcengine Ark のリクエスト構造を直接使用する場合は、ネイティブ形式の作成 APIを参照してください。

標準版 Seedance 2.0 は 480p/720p/1080p/4k、Seedance 2.0 fast は 480p/720p のみをサポートします。実際のモデルに応じて解像度を選択してください。

POST/v1/video/generations

非同期動画生成タスクを作成します。送信に成功すると Task ID が返され、動画はこの API では同期的に返されません。

doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128 などのモデルに対応します。実際に利用できるモデルは、現在の API Key に返されるモデル一覧に従います。

認証

bearerAuth

認証Bearer <token>

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

指定位置: header

リクエストボディ

application/json

Seedance 2.0 の動画生成パラメーターです。

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

Seedance 2.0 のモデル ID、またはこのモデルを設定した推論 Endpoint ID です。doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128 に対応します。実際の利用範囲は現在の API Key によって異なります。

長さ1 <= length

content*array<>

入力リスト。参照モードは画像 9 枚、動画 3 本、音声 3 本までです。動画と音声は各 2～15 秒、同種素材の合計は 15 秒以内です。音声には画像または動画が必要です。先頭フレーム・先頭末尾フレーム方式とマルチモーダル参照は併用できません。

項目数1 <= items

generate_audio?boolean

映像と同期する音声を生成するかどうかです。true の場合、モデルはプロンプトと視覚コンテンツに基づいて、音声、効果音、BGM を生成できます。false の場合は無音動画を出力します。

ratio?string

動画のアスペクト比です。Seedance 2.0 と Seedance 2.0 fast はデフォルトで adaptive を使用し、入力に応じて適切なアスペクト比を自動選択します。

デフォルト値"adaptive"

指定可能な値

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

duration?|unknown

生成動画の長さ（秒）です。Seedance 2.0 と Seedance 2.0 fast は 4～15 の整数、またはモデルに長さを決定させる -1 をサポートします。

resolution?string

動画の解像度。既定は 720p です。標準 Seedance 2.0 は 480p/720p/1080p/4k、Seedance 2.0 fast は 480p/720p のみ対応します。

デフォルト値"720p"

指定可能な値

"480p"
"720p"
"1080p"
"4k"

watermark?boolean

生成動画にウォーターマークを追加するかどうかです。

seed?integer

乱数シードです。範囲は -1～4294967295 です。同じシードを使用すると再現性が高まる場合がありますが、完全に同じ結果は保証されません。

範囲-1 <= value <= 4294967295

return_last_frame?boolean

連続動画の生成に使う透かしなし JPEG 末尾フレームを返すかどうか。

callback_url?string

タスクステータスが変化したときに POST コールバックを受け取る URL です。コールバック本文の構造はタスク取得 API のレスポンスと同じです。設定しない場合はタスクステータスをポーリングできます。

形式uri

safety_identifier?string

利用規約に違反する可能性のあるユーザーの識別を支援する、エンドユーザーの安定した一意識別子です。ユーザー名、ユーザー ID、メールアドレスをハッシュ化した文字列を使用し、個人情報を送信しないことを推奨します。

長さ1 <= length <= 64

execution_expires_after?integer

タスク作成時点からの有効時間（秒）です。この時間を超えても未完了のタスクは終了され、expired としてマークされます。

形式int32

範囲3600 <= value <= 259200

デフォルト値172800

tools?array<>

モデルが呼び出せるツールの一覧です。例：web_search。ツールタイプと拡張パラメーターは現在のモデルおよびアカウント機能によって異なります。

service_tier?string

タスクで使用するサービス階層です。Seedance 2.0 と Seedance 2.0 fast は default のオンライン推論サービスを使用し、flex のオフライン推論はサポートしません。

デフォルト値"default"

priority?integer

同じ推論エンドポイント内のキュー優先度。0～9 で大きいほど優先されます。同じ優先度は送信順で処理し、実行中のタスクは中断しません。

範囲0 <= value <= 9

デフォルト値0

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "content": [      {        "type": "text",        "text": "クリスマスの小さなウサギが空を飛んでいる"      }    ],    "generate_audio": true,    "ratio": "16:9",    "duration": 11,    "resolution": "1080p",    "watermark": false,    "execution_expires_after": 172800  }'

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

Volcengine Ark 動画生成タスク作成の公式ドキュメントSeedance 動画生成タスクの上流プロトコル定義と最新のフィールド変更を確認します。

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`