ToAPIsToAPIs
seedance-2

seedance-2 視頻生成

使用 seedance-2、seedance-2-fast 與 seedance-2-mini 模型生成視頻

POST
/v1/videos/generations

中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。

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

Authorizations

Authorizationstring請求頭必填

所有接口均需要使用 Bearer Token 進行認證

獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key

使用時在請求頭中添加:

Authorization: Bearer YOUR_API_KEY

Body

modelstring請求體必填預設值: seedance-2

視頻生成模型名稱

可用模型:

  • seedance-2 - 標準版,適合更高質量輸出與更完整的 Seedance 2 能力
  • seedance-2-fast - 快速版,適合預覽、迭代和更低延遲場景
  • seedance-2-mini - 輕量版,適合低成本草稿和多模態參考工作流,當前固定單次生成 1 個結果
promptstring請求體

視頻內容描述

支持中英文輸入。建議明確描述場景、鏡頭運動、主體動作、風格和聲音氛圍。

建議:

  • 中文儘量控制在 500 字以內
  • 英文儘量控制在 1000 詞以內
  • 需要引用參考素材時,使用“圖片1 / 視頻1 / 音頻1”的方式指代
client_business_idstring請求體

客戶側業務 ID,例如訂單號、流水號或您系統內的任務 ID。提交後會隨任務保存,後續可用該 ID 查詢狀態: GET /v1/videos/generations/{client_business_id}。

也兼容放在 metadata.client_business_id 中,但推薦使用頂層字段。

durationinteger請求體預設值: 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_ratiostring請求體

視頻寬高比

可選項:

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

建議優先使用 aspect_ratio 作爲對外字段。adaptive 表示由上游根據輸入素材自動選擇合適比例。

image_urlsstring[]請求體

兼容模式下的圖片 URL 數組

推薦優先使用 image_with_roles,這樣可以顯式聲明 first_frame、last_frame 或 reference_image。

兼容規則:

  • 傳 1 張圖時,通常按首幀圖處理
  • 傳多張圖時,角色推斷會帶來歧義,不建議用於新接入
  • image_urls 不應與 image_with_roles 同時使用。
  • 新接入建議使用 image_with_roles 顯式聲明圖片用途,避免兼容推斷帶來的歧義。
image_with_rolesarray請求體

帶角色的圖片數組

支持場景:

  • seedance-2 / seedance-2-fast / seedance-2-mini
    • 首幀圖生視頻:first_frame 1 張
    • 首尾幀圖生視頻:first_frame 1 張 + last_frame 1 張
    • 多模態參考生視頻:reference_image 1-9 張
字段說明
urlstring請求體必填

圖片 URL

支持:

  • https://...
rolestring請求體必填

圖片角色

可選項:

  • first_frame - 首幀圖
  • last_frame - 尾幀圖
  • reference_image - 參考圖
  • first_frame 最多 1 張
  • last_frame 最多 1 張
  • reference_image 最多 9 張
  • 首幀/首尾幀模式不能與參考模式混用
  • seedance-2-mini 同樣支持 first_frame、last_frame 與 reference_image
video_with_rolesarray請求體

帶角色的視頻數組

當前僅支持多模態參考模式使用 reference_video。

字段說明
urlstring請求體必填

視頻 URL

支持:

  • https://...
rolestring請求體必填

固定爲:

  • reference_video

限制:

  • seedance-2-mini 最多 3 條參考視頻
audio_with_rolesarray請求體

帶角色的音頻數組

當前僅支持多模態參考模式使用 reference_audio。

字段說明
urlstring請求體必填

音頻 URL

支持:

  • https://...
rolestring請求體必填

固定爲:

  • reference_audio

限制:

  • seedance-2-mini 最多 3 段參考音頻

audio_with_roles 不能單獨使用,至少還需要一個圖片或視頻參考輸入。

resolutionstring請求體預設值: 720p

視頻分辨率

可選項:

  • seedance-2:480p、720p、1080p、4k
  • seedance-2-fast:480p、720p
  • seedance-2-mini:480p、720p
generate_audioboolean請求體預設值: true

是否生成同步音頻

  • true:生成帶音頻的視頻
  • false:生成無聲視頻

seedance-2-mini 同樣支持該字段。

return_last_frameboolean請求體預設值: false

是否返回生成視頻的尾幀圖像。

設為 true 後,任務完成時可從狀態查詢響應的 result.data[0].last_frame_url 獲取尾幀圖像 URL。

toolsarray請求體

配置模型可調用的工具。目前 Seedance 2 系列僅支持聯網搜索:

[{ "type": "web_search" }]

啓用後,模型會根據提示詞自主判斷是否搜索互聯網內容。實際搜索次數通過狀態查詢響應的 usage.tool_usage.web_search 獲取,值爲 0 表示未執行搜索。

tools 僅支持純文本生成視頻請求,不能與圖片、視頻或音頻輸入同時使用。

seedinteger請求體

隨機種子,用於控制生成隨機性

callback_urlstring請求體

ToAPIs 標準任務完成回調。需先設定 Token URL 與密鑰,只允許同源覆蓋。詳見 Webhook。

trace_idstring請求體

調用方自定義透傳 ID

調用方追蹤欄位,與 Webhook 是否啟用無關。

disable_nsfwboolean請求體預設值: true

默認禁止生成 NSFW 內容。顯式設為 false 時允許。

素材審核

請求帶有圖片, 視頻或音頻素材時, 部分渠道會在提交生成前自動審核素材. 無需額外參數, 在原有媒體欄位中傳入素材 URL 即可.

  • 請求受理後立即返回視頻任務. 需要審核時任務維持 queued, 本次請求的素材全部通過後才提交生成. 首次審核可能需要數分鐘, 同一使用者在同一渠道重複使用相同 URL 時會重用審核結果.
  • 每輪素材準備預設最長 20 分鐘. 素材被拒絕或準備逾時會結束任務, 狀態為 failed, 原因見 error.message. 審核未通過不收取視頻生成費用.
  • 素材須為公網 HTTP(S) URL, 不接受 Base64 與本機路徑. 圖片建議不超過 30 MB, 視頻與音頻不超過 100 MiB; 各模型原有的格式限制不變.
  • 需要審核的渠道會在受理時驗證素材: URL 帶有帳號密碼或超過 2048 位元組, 同一 URL 被用作不同型別, 或單次請求的素材引用超過 64 個時, 直接返回 HTTP 400, error.code 為 invalid_private_assets.
  • 平台依 URL 識別素材. 檔案內容變更後請改用新的 URL.
  • 舊的 asset:// 素材引用已停用, 會返回 HTTP 400.

輸入組合規則

支持的典型輸入組合:

  • 純文本:文生視頻
  • 文本 + 1 張首幀圖:首幀圖生視頻
  • 文本 + 首幀圖 + 尾幀圖:首尾幀圖生視頻
  • 文本 + 參考圖:多模態參考生視頻
  • 文本 + 參考視頻:視頻參考生視頻
  • 文本 + 參考圖 + 參考音頻:多模態參考生視頻
  • 文本 + 參考圖 + 參考視頻 + 參考音頻:多模態參考生視頻

三種模式互斥:

  • 首幀圖生視頻
  • 首尾幀圖生視頻
  • 多模態參考生視頻

seedance-2-mini 也支持首幀 / 首尾幀模式;需要首尾幀控制時請使用 image_with_roles 顯式傳入 first_frame / last_frame。

能力與約束

項目seedance-2seedance-2-fastseedance-2-mini
主要定位更高質量與更長時長更快生成與更低延遲低成本草稿與多模態參考
時長4-15 秒,支持自動時長4-15 秒,支持自動時長4-15 秒
分辨率480p / 720p / 1080p / 4k480p / 720p480p / 720p
圖片角色first_frame / last_frame / reference_imagefirst_frame / last_frame / reference_imagefirst_frame / last_frame / reference_image
視頻角色reference_videoreference_videoreference_video
音頻角色reference_audioreference_audioreference_audio
首尾幀模式支持支持支持
參考圖上限999
參考視頻上限以實際通道能力爲準以實際通道能力爲準3
參考音頻上限以實際通道能力爲準以實際通道能力爲準3
同步音頻generate_audiogenerate_audiogenerate_audio
ToAPIs 回調callback_url(trace_id 可選追蹤)callback_url(trace_id 可選追蹤)callback_url(trace_id 可選追蹤)

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

完成後透過影片任務查詢取得結果. 啟用原始位址交付時優先使用 result.data[].url; 主要位址無法存取時, 再使用可選的 fallback_url. 尾幀對應 last_frame_url 和 fallback_last_frame_url, 備用欄位僅在副本可用時回傳.

Response

idstring

任務 ID,用於查詢任務狀態。

client_business_idstring

客戶側業務 ID。僅當請求中傳入 client_business_id 時返回。

objectstring

對象類型,固定爲 generation.task。

modelstring

本次請求使用的模型名稱。

statusstring

任務狀態:queued、in_progress、completed 或 failed。

progressinteger

任務進度百分比(0-100)。

created_atinteger

任務創建時間戳。

提交接口返回的是基礎任務對象;當任務完成後,請使用 獲取視頻任務狀態 獲取 completed_at、expires_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。

請求示例

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"
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "鏡頭從窗邊花束慢慢推到餐桌中央,畫面色調溫暖柔和。",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/first-frame.png", "role": "first_frame"},
      {"url": "https://example.com/last-frame.png", "role": "last_frame"}
    ],
    "resolution": "720p",
    "generate_audio": false
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "prompt": "微距鏡頭拍攝一隻玻璃蛙停在葉片上,鏡頭緩慢切到透明腹部與跳動心臟,紀錄片風格。",
    "duration": 11,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "generate_audio": true
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-fast",
    "prompt": "一隻柴犬在雨後的霓虹街頭奔跑,地面倒映彩色燈光。",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-mini",
        "prompt": "保持人物形象一致,參考圖片和視頻的節奏,生成一段簡短室內廣告視頻",
        "duration": 8,
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "image_with_roles": [
            {"url": "https://example.com/ref.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/ref.mp4", "role": "reference_video"}
        ],
    },
)

print(response.json())

響應示例

{
  "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
}