Seedance 2.5 建立影片（平台格式）

支援文字、圖片、影片和音訊參考輸入，可用於文字生成影片、起始影格或起始與結束影格生成影片、多模態參考生成、影片編輯和影片延長。

如需直接使用火山方舟請求結構，請參閱原生格式建立 API。

先生成低解析度樣片、確認效果後再製作正式影片，請參閱 Draft 樣片生成指南。樣片使用 480p，基於樣片生成的正式影片使用 1080p。

POST/v1/video/generations

使用平台 Video Generations 路徑建立 Seedance 2.5 非同步影片任務。API 回傳任務物件和用於查詢結果的任務 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 秒。支援純音訊參考；首幀、首尾幀模式不能與多模態參考模式混用。

提示詞可使用 @圖像1、@影片1、@音訊1 等方式參照陣列中對應順序的素材。

項目數1 <= items

draft?boolean

是否產生 Draft 樣片。設為 true 時必須使用 480p；樣片成功後可於七天內透過 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 適合網頁與常規分發；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

任務完成後的回呼網址。未設定時可以透過查詢 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
}

火山方舟建立影片生成任務官方文件檢視 Seedance 影片生成任務的上游協定定義與最新欄位變更。

Seedance 2.5 建立影片（平台格式）

授權

請求主體

回應主體

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`