Dreamina Seedance
Dreamina-Seedance-2.0 · 動画生成
動画 / Dreamina / Dreamina-Seedance-2.0 / 動画生成
| エンドポイント | メソッド | パス |
|---|---|---|
| タスク送信 | POST | /v1/videos/generations |
| 結果照会 | GET | /v1/videos/generations/{id} |
リクエストパラメータ
Authorization
Header に Authorization を追加し、値は Bearer の後に API キーを続けます。
Authorization: Bearer ****************
Header パラメータ
Content-Typestring任意
application/json
Acceptstring任意
application/json
Body パラメータapplication/json必須
modelstring必須
モデル ID。`dreamina-seedance-2-0-260128` に固定
contentarray[object]必須
BytePlus ネイティブ入力配列(推奨メイン用法)、下記 5 種類の type を組み合わせて使用。role は type と同じ階層(content item の外側)に置き、image_url/video_url の子オブジェクト内には入れないこと。role の値:画像 first_frame/last_frame/reference_image;動画 reference_video。
callback_urlstring任意
タスク状態変更時のコールバック通知先(任意)
return_last_frameboolean任意
動画の最終フレーム画像を返すか(既定 false)
resolutionstring任意
480p / 720p / 1080p / 4k動画解像度(既定 720p;4k は Seedance 2.0 のみ)
ratiostring任意
16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptive生成動画のアスペクト比(既定 adaptive)
durationinteger任意
動画の長さ(秒)、既定 5
seedinteger任意
乱数シード、既定 -1(ランダム);範囲 [-1, 2^32-1]
camera_fixedboolean任意
カメラを固定するか(既定 false)
watermarkboolean任意
透かしを追加するか(既定 false)
service_tierstring任意
default / flexサービス階層:default(オンライン推論)/ flex(オフライン、半額;Seedance 2.0 系列は非対応)
execution_expires_afterinteger任意
タスクのタイムアウト(秒)、created_at 起算;既定 172800(48h)、範囲 [3600, 259200]
generate_audioboolean任意
出力に同期音声を含めるか(既定 true;Seedance 2.0 系列 / 1.5 Pro のみ)
draftboolean任意
下書きモードを有効化(既定 false;Seedance 1.5 Pro のみ;下書きは 480p 固定)
safety_identifierstring任意
プラットフォームのリスク検知用のエンドユーザー一意識別子
例
{ "model": "dreamina-seedance-2-0-260128", "content": [ { "type": "text", "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン" } ], "resolution": "720p", "ratio": "16:9", "duration": 5, "seed": 11, "camera_fixed": false, "watermark": false}リクエストコード例
curl https://api.hotrouter.ai/v1/videos/generations \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "dreamina-seedance-2-0-260128", "content": [ { "type": "text", "text": "岩に打ち寄せる波のスローモーション、夕暮れの暖色トーン" } ], "resolution": "720p", "ratio": "16:9", "duration": 5, "seed": 11, "camera_fixed": false, "watermark": false }'レスポンス
タスク送信
{ "id": "cgt-xxxxxxxx", "status": "queued"}結果照会
{ "id": "cgt-xxxxxxxx", "status": "succeeded", "content": { "video_url": "https://.../video.mp4" }, "usage": { "completion_tokens": 0 }}
