Skip to main content
POST
  • 支持 seedance-2seedance-2-fastseedance-2-mini
  • 支持文生視頻、首幀/首尾幀圖生視頻與多模態參考生視頻;seedance-2-mini 的首尾幀與音頻開關能力也已開放
  • 支持參考圖、參考視頻、參考音頻聯合控制;seedance-2-mini 最多支持 9 張圖、3 條視頻、3 條音頻
  • 異步任務管理,提交後返回 generation.task,完成結果通過任務查詢接口獲取

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"seedance-2"
必填
視頻生成模型名稱可用模型:
  • seedance-2 - 標準版,適合更高質量輸出與更完整的 Seedance 2 能力
  • seedance-2-fast - 快速版,適合預覽、迭代和更低延遲場景
  • seedance-2-mini - 輕量版,適合低成本草稿和多模態參考工作流,當前固定單次生成 1 個結果
string
視頻內容描述支持中英文輸入。建議明確描述場景、鏡頭運動、主體動作、風格和聲音氛圍。建議:
  • 中文儘量控制在 500 字以內
  • 英文儘量控制在 1000 詞以內
  • 需要引用參考素材時,使用“圖片1 / 視頻1 / 音頻1”的方式指代
string
客戶側業務 ID,例如訂單號、流水號或您系統內的任務 ID。提交後會隨任務保存,後續可用該 ID 查詢狀態: GET /v1/videos/generations/{client_business_id}也兼容放在 metadata.client_business_id 中,但推薦使用頂層字段。
integer
預設值:0
視頻時長(秒)取值規則:
  • seedance-24-15
  • seedance-2-fast4-15
  • seedance-2-mini4-15
  • 0:自動時長(僅 seedance-2 / seedance-2-fast
  • -1:自動時長(僅 seedance-2 / seedance-2-fast
string
視頻寬高比可選項:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive
建議優先使用 aspect_ratio 作爲對外字段。adaptive 表示由上游根據輸入素材自動選擇合適比例。
string[]
兼容模式下的圖片 URL 數組推薦優先使用 image_with_roles,這樣可以顯式聲明 first_framelast_framereference_image兼容規則:
  • 傳 1 張圖時,通常按首幀圖處理
  • 傳多張圖時,角色推斷會帶來歧義,不建議用於新接入
  • image_urls 不應與 image_with_roles 同時使用。
  • 新接入建議使用 image_with_roles 顯式聲明圖片用途,避免兼容推斷帶來的歧義。
array
帶角色的圖片數組支持場景:
  • seedance-2 / seedance-2-fast / seedance-2-mini
    • 首幀圖生視頻:first_frame 1 張
    • 首尾幀圖生視頻:first_frame 1 張 + last_frame 1 張
    • 多模態參考生視頻:reference_image 1-9 張
  • first_frame 最多 1 張
  • last_frame 最多 1 張
  • reference_image 最多 9
  • 首幀/首尾幀模式不能與參考模式混用
  • seedance-2-mini 同樣支持 first_framelast_framereference_image
array
帶角色的視頻數組當前僅支持多模態參考模式使用 reference_video限制:
  • seedance-2-mini 最多 3 條參考視頻
array
帶角色的音頻數組當前僅支持多模態參考模式使用 reference_audio限制:
  • seedance-2-mini 最多 3 段參考音頻
audio_with_roles 不能單獨使用,至少還需要一個圖片或視頻參考輸入。
string
預設值:"720p"
視頻分辨率可選項:
  • seedance-2480p720p1080p4k
  • seedance-2-fast480p720p
  • seedance-2-mini480p720p
boolean
預設值:true
是否生成同步音頻
  • true:生成帶音頻的視頻
  • false:生成無聲視頻
seedance-2-mini 同樣支持該字段。
boolean
預設值:false
是否返回生成視頻的尾幀圖像。設為 true 後,任務完成時可從狀態查詢響應的 result.data[0].last_frame_url 獲取尾幀圖像 URL。
array
配置模型可調用的工具。目前 Seedance 2 系列僅支持聯網搜索:
啓用後,模型會根據提示詞自主判斷是否搜索互聯網內容。實際搜索次數通過狀態查詢響應的 usage.tool_usage.web_search 獲取,值爲 0 表示未執行搜索。
tools 僅支持純文本生成視頻請求,不能與圖片、視頻或音頻輸入同時使用。
integer
隨機種子,用於控制生成隨機性
string
ToAPIs 標準任務完成回調。需先設定 Token URL 與密鑰,只允許同源覆蓋。詳見 Webhook
string
調用方自定義透傳 ID調用方追蹤欄位,與 Webhook 是否啟用無關。

使用已入庫素材

如果你已經通過私域素材接口完成了素材入庫,並拿到了可用的 asset_id,那麼在視頻生成接口中,你不需要再傳原始素材 URL,而是直接使用:
  • asset://<ASSET_ID>
適用範圍:
  • 虛擬人像素材
  • 真人人像素材
  • 已經處理完成並處於 active 狀態的圖片、視頻、音頻素材
使用前你需要先完成以下流程:
  1. 先在素材接口中創建素材組或完成真人認證
  2. 上傳素材並拿到 asset_id
  3. 輪詢素材狀態,確認已經變爲 active
  4. 在視頻生成請求中把素材地址寫成 asset://<ASSET_ID>
你可以參考這兩組素材文檔完成入庫:

在生成請求中的寫法

圖片素材可用於:
  • first_frame
  • last_frame
  • reference_image
視頻素材可用於:
  • reference_video
音頻素材可用於:
  • reference_audio
最小示例:
包含視頻和音頻參考的示例:
只有狀態爲 active 的素材才能用於視頻生成。如果你傳入了 asset://<ASSET_ID> 但素材仍在 processing 或已經 failed,生成請求會失敗或無法達到預期效果。

輸入組合規則

支持的典型輸入組合:
  • 純文本:文生視頻
  • 文本 + 1 張首幀圖:首幀圖生視頻
  • 文本 + 首幀圖 + 尾幀圖:首尾幀圖生視頻
  • 文本 + 參考圖:多模態參考生視頻
  • 文本 + 參考視頻:視頻參考生視頻
  • 文本 + 參考圖 + 參考音頻:多模態參考生視頻
  • 文本 + 參考圖 + 參考視頻 + 參考音頻:多模態參考生視頻
三種模式互斥:
  • 首幀圖生視頻
  • 首尾幀圖生視頻
  • 多模態參考生視頻
seedance-2-mini 也支持首幀 / 首尾幀模式;需要首尾幀控制時請使用 image_with_roles 顯式傳入 first_frame / last_frame

能力與約束

seedance-2-mini 當前固定單次生成 1 個結果,不暴露 count / n。首尾幀控制請通過 image_with_rolesfirst_frame / last_frame 表達。

Response

string
任務 ID,用於查詢任務狀態。
string
客戶側業務 ID。僅當請求中傳入 client_business_id 時返回。
string
對象類型,固定爲 generation.task
string
本次請求使用的模型名稱。
string
任務狀態:queuedin_progresscompletedfailed
integer
任務進度百分比(0-100)。
integer
任務創建時間戳。
提交接口返回的是基礎任務對象;當任務完成後,請使用 獲取視頻任務狀態 獲取 completed_atexpires_at 以及 result.type = "video" / result.data[].url / result.data[].format。啓用 return_last_frame 時,尾幀 URL 位於 result.data[0].last_frame_url;啓用 web_search 時,搜索次數位於 usage.tool_usage.web_search