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

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

テキスト、画像、動画、音声の参照入力に対応し、テキストからの動画生成、開始フレームまたは開始・終了フレームからの動画生成、マルチモーダル参照生成、動画編集、動画延長に使用できます。

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

低解像度のサンプルで効果を確認してから正式動画を生成する手順は、Draft サンプル動画生成ガイドをご覧ください。サンプルは 480p、サンプルから生成する正式動画は 1080p を使用します。

POST/v1/video/generations

Platform Video Generations パスで Seedance 2.5 の非同期動画タスクを作成します。API はタスクオブジェクトと、結果取得に使用する Task ID を返します。

Seedance 2.5 は最長 30 秒の動画、最大 50 件のマルチモーダル参照素材、mp4 と mov の出力に対応します。動画編集タスクでは ratio を adaptive、duration を -1 にする必要があります。

認証

bearerAuth

認証Bearer <token>

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

指定位置: header

リクエストボディ

application/json

Seedance 2.5 の動画生成パラメーターです。素材ロール、アスペクト比、長さの制約はタスクタイプによって異なります。

TypeScript 型定義

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

model*string

Seedance 2.5 のモデル ID です。例：doubao-seedance-2-5-260628。実際の呼び出しでは、現在の API Key で表示されるモデルを使用してください。

長さ1 <= length

content*array<|>

テキスト、画像、動画、音声、または Draft タスク ID の入力リストです。マルチモーダル参照は最大 50 素材（画像 30 枚、動画 10 本、音声 10 本）です。動画と音声は各 2～30 秒、同種素材の合計は 30 秒以内です。動画編集の参照動画は 4～30 秒です。音声のみの参照に対応します。先頭フレーム・先頭末尾フレーム方式とマルチモーダル参照は併用できません。

プロンプトでは配列順に @image1、@video1、@audio1 で素材を参照できます。

項目数1 <= items

draft?boolean

Draft プレビューを生成するかどうか。true の場合は 480p が必須です。成功後 7 日以内に content.draft_task.id を参照し、1080p の正式動画を生成できます。正式生成では省略するか false にします。

omni_reference_task_type?string

マルチモーダル参照のタスク種別。auto は自動判定、reference は参照生成、edit は動画編集（参照動画と ratio=adaptive、duration=-1 が必須）、extend は動画延長（参照動画と ratio=adaptive が必須）です。明示すると制約を事前検証します。プロンプトの意図も選択した種別と一致させてください。

デフォルト値"auto"

指定可能な値

"auto"
"reference"
"edit"
"extend"

generate_audio?boolean

映像に合う音声を生成するかどうかです。有効にすると、通常は生成時間と料金が増加します。

ratio?string

動画のアスペクト比です。テキストからの動画生成とマルチモーダル参照からの動画生成では比率を指定するか adaptive を使用できます。開始フレーム、開始・終了フレーム、動画編集、動画延長タスクでは adaptive のみ使用できます。

デフォルト値"adaptive"

指定可能な値

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

duration?|integer

生成時間（秒）です。4～30、またはモデルに自動決定させる -1 を指定できます。動画編集タスクは -1 のみ、動画延長は 4～30 または -1 をサポートします。

デフォルト値-1

resolution?string

出力動画の解像度です。480p、720p、1080p に対応します。実際のピクセルサイズは、解像度、アスペクト比、現在のモデル能力によって決まります。

デフォルト値"720p"

指定可能な値

"480p"
"720p"
"1080p"

output_format?string

出力動画形式です。mp4 は Web や一般的な配信に適しています。mov は H.264、YUV444P、PCM を使用し、カラーグレーディング、キーイング、合成などのポストプロダクションに適しています。

デフォルト値"mp4"

指定可能な値

"mp4"
"mov"

watermark?boolean

ウォーターマークを追加するかどうかです。利用可否はモデル権限とサービス設定によって異なります。

seed?integer

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

範囲-1 <= value <= 4294967295

return_last_frame?boolean

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

callback_url?string

タスク完了後のコールバック URL です。設定しない場合は、取得 API でタスクステータスをポーリングできます。

形式uri

safety_identifier?string

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

長さ1 <= length <= 64

execution_expires_after?integer

タスク作成時点からの有効時間（秒）です。この時間を超えても未完了のタスクは期限切れ状態になります。

形式int32

範囲3600 <= value <= 259200

デフォルト値172800

tools?array<>

モデルが呼び出せるツールの一覧です。例：web_search。利用可能なツールと具体的なパラメーターは現在のアカウント権限によって異なります。

service_tier?string

サービス階層。Seedance 2.5 は default のオンライン推論を使用し、flex は非対応です。キューの優先度は別の priority パラメーターで設定します。

デフォルト値"default"

priority?integer

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

範囲0 <= value <= 9

デフォルト値0

[key: string]?any

レスポンスボディ

`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": 10,    "resolution": "1080p",    "output_format": "mp4",    "watermark": false  }'

{
  "id": "task_xxxxx",
  "task_id": "task_xxxxx",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1786082400
}

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

Seedance 2.5 動画を作成（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`