跳轉到主要內容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "保持圖片1中的人物形象，參考視頻1的運鏡和音頻1的節奏，生成一段室內產品口播短視頻。",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}
  • 支持 seedance-2、seedance-2-fast 與 seedance-2-mini
  • 支持文生視頻、多模態參考生視頻；seedance-2 與 seedance-2-fast 額外支持首幀/首尾幀圖生視頻
  • 支持參考圖、參考視頻、參考音頻聯合控制；seedance-2-mini 最多支持 9 張圖、3 條視頻、3 條音頻
  • 異步任務管理，提交後返回 generation.task，完成結果通過任務查詢接口獲取

​
Authorizations

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

​
Body

​
model
string
預設值:"seedance-2"
必填
視頻生成模型名稱可用模型：
  • seedance-2 - 標準版，適合更高質量輸出與更完整的 Seedance 2 能力
  • seedance-2-fast - 快速版，適合預覽、迭代和更低延遲場景
  • seedance-2-mini - 輕量版，適合低成本草稿和多模態參考工作流，當前固定單次生成 1 個結果
​
prompt
string
視頻內容描述支持中英文輸入。建議明確描述場景、鏡頭運動、主體動作、風格和聲音氛圍。建議：
  • 中文儘量控制在 500 字以內
  • 英文儘量控制在 1000 詞以內
  • 需要引用參考素材時，使用“圖片1 / 視頻1 / 音頻1”的方式指代
​
client_business_id
string
客戶側業務 ID，例如訂單號、流水號或您系統內的任務 ID。提交後會隨任務保存，後續可用該 ID 查詢狀態： GET /v1/videos/generations/{client_business_id}。也兼容放在 metadata.client_business_id 中，但推薦使用頂層字段。
​
duration
integer
預設值:0
視頻時長（秒）取值規則：
  • seedance-2：4-15
  • seedance-2-fast：4-15
  • seedance-2-mini：4-15
  • 0：自動時長（僅 seedance-2 / seedance-2-fast）
  • -1：自動時長（僅 seedance-2 / seedance-2-fast）
​
aspect_ratio
string
視頻寬高比可選項：
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
建議優先使用 aspect_ratio 作爲對外字段。
​
image_urls
string[]
兼容模式下的圖片 URL 數組推薦優先使用 image_with_roles，這樣可以顯式聲明 first_frame、last_frame 或 reference_image。兼容規則：
  • 傳 1 張圖時，通常按首幀圖處理
  • 傳多張圖時，角色推斷會帶來歧義，不建議用於新接入
  • image_urls 不應與 image_with_roles 同時使用。
  • seedance-2-mini 不支持首幀 / 尾幀模式，請改用 image_with_roles + reference_image。
​
image_with_roles
array
帶角色的圖片數組支持場景：
  • seedance-2 / seedance-2-fast
    • 首幀圖生視頻：first_frame 1 張
    • 首尾幀圖生視頻：first_frame 1 張 + last_frame 1 張
    • 多模態參考生視頻：reference_image 1-9 張
  • seedance-2-mini
    • 多模態參考生視頻：reference_image 1-9 張
  • first_frame 最多 1 張
  • last_frame 最多 1 張
  • reference_image 最多 9 張
  • 首幀/首尾幀模式不能與參考模式混用
  • seedance-2-mini 僅支持 reference_image，不支持 first_frame / last_frame
​
video_with_roles
array
帶角色的視頻數組當前僅支持多模態參考模式使用 reference_video。限制：
  • seedance-2-mini 最多 3 條參考視頻
​
audio_with_roles
array
帶角色的音頻數組當前僅支持多模態參考模式使用 reference_audio。限制：
  • seedance-2-mini 最多 3 段參考音頻
audio_with_roles 不能單獨使用，至少還需要一個圖片或視頻參考輸入。
​
resolution
string
預設值:"720p"
視頻分辨率可選項：
  • seedance-2：480p、720p、1080p、4k
  • seedance-2-fast：480p、720p
  • seedance-2-mini：480p、720p
​
generate_audio
boolean
預設值:true
是否生成同步音頻
  • true：生成帶音頻的視頻
  • false：生成無聲視頻
seedance-2-mini 當前不開放 generate_audio 字段，請不要傳該參數。
​
seed
integer
隨機種子，用於控制生成隨機性
​
callback_url
string
異步任務回調地址需與 trace_id 一起傳遞時才生效。
​
trace_id
string
調用方自定義透傳 ID回調觸發時會原樣返回，需與 callback_url 一起傳遞時才生效。

​
使用已入庫素材

如果你已經通過私域素材接口完成了素材入庫，並拿到了可用的 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
最小示例： 
{
  "model": "seedance-2-mini",
  "prompt": "讓圖片1中的人物站在落地窗前緩慢轉身，鏡頭輕微推進，保持人物服裝和麪部特徵一致",
  "image_with_roles": [
    {
      "url": "asset://asset_img_01KXXXXXXX",
      "role": "reference_image"
    }
  ]
}
包含視頻和音頻參考的示例： 
{
  "model": "seedance-2-mini",
  "prompt": "保持圖片1中的人物形象，參考視頻1的鏡頭運動和音頻1的節奏氛圍，生成一段室內口播視頻",
  "image_with_roles": [
    {
      "url": "asset://asset_img_01KXXXXXXX",
      "role": "reference_image"
    }
  ],
  "video_with_roles": [
    {
      "url": "asset://asset_vid_01KXXXXXXX",
      "role": "reference_video"
    }
  ],
  "audio_with_roles": [
    {
      "url": "asset://asset_aud_01KXXXXXXX",
      "role": "reference_audio"
    }
  ]
}
只有狀態爲 active 的素材才能用於視頻生成。如果你傳入了 asset://<ASSET_ID> 但素材仍在 processing 或已經 failed，生成請求會失敗或無法達到預期效果。

​
輸入組合規則

支持的典型輸入組合：
  • 純文本：文生視頻
  • 文本 + 1 張首幀圖：首幀圖生視頻（僅 seedance-2 / seedance-2-fast）
  • 文本 + 首幀圖 + 尾幀圖：首尾幀圖生視頻（僅 seedance-2 / seedance-2-fast）
  • 文本 + 參考圖：多模態參考生視頻
  • 文本 + 參考視頻：視頻參考生視頻
  • 文本 + 參考圖 + 參考音頻：多模態參考生視頻
  • 文本 + 參考圖 + 參考視頻 + 參考音頻：多模態參考生視頻
三種模式互斥：
  • 首幀圖生視頻
  • 首尾幀圖生視頻
  • 多模態參考生視頻
seedance-2-mini 僅支持多模態參考模式，不支持 first_frame / last_frame。

​
能力與約束

項目seedance-2seedance-2-fastseedance-2-mini
主要定位更高質量與更長時長更快生成與更低延遲低成本草稿與多模態參考
時長4-15 秒，支持自動時長4-15 秒，支持自動時長4 / 8 / 10 / 12 / 15 秒
分辨率480p / 720p / 1080p / 4k480p / 720p480p / 720p
圖片角色first_frame / last_frame / reference_imagefirst_frame / last_frame / reference_imagereference_image
視頻角色reference_videoreference_videoreference_video
音頻角色reference_audioreference_audioreference_audio
首尾幀模式支持支持不支持
參考圖上限999
參考視頻上限以實際通道能力爲準以實際通道能力爲準3
參考音頻上限以實際通道能力爲準以實際通道能力爲準3
同步音頻generate_audiogenerate_audio不開放該字段
回調通知callback_url + trace_idcallback_url + trace_idcallback_url + trace_id
seedance-2-mini 當前固定單次生成 1 個結果，不暴露 count / n；同時不支持 media_mode=frame、first_frame、last_frame、return_last_frame。

​
Response

​
id
string
任務 ID，用於查詢任務狀態。
​
client_business_id
string
客戶側業務 ID。僅當請求中傳入 client_business_id 時返回。
​
object
string
對象類型，固定爲 generation.task。
​
model
string
本次請求使用的模型名稱。
​
status
string
任務狀態：queued、in_progress、completed 或 failed。
​
progress
integer
任務進度百分比（0-100）。
​
created_at
integer
任務創建時間戳。
提交接口返回的是基礎任務對象；當任務完成後，請使用 獲取視頻任務狀態 獲取 completed_at、expires_at 以及 result.type = "video" / result.data[].url / result.data[].format。
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "保持圖片1中的人物形象，參考視頻1的運鏡和音頻1的節奏，生成一段室內產品口播短視頻。",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}