ToAPIsToAPIs
seedance-2-5

seedance-2.5 樣片模式

先用低成本樣片確認效果,再用樣片任務生成 1080p 成稿

POST
/v1/videos/generations

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

樣片模式把一次生成拆成兩個階段:先按較低成本生成 480p 樣片,確認運鏡和畫面後,再用該樣片生成 1080p 成稿。成稿由上游複用樣片的提示詞和素材,因此第二階段不需要重複提交這些內容。

兩個階段都呼叫 POST /v1/videos/generations,並使用同一個 seedance-2-5 模型。

兩階段流程

  1. 提交樣片請求,帶上 draft: true,從回應中取得樣片任務 ID。
  2. 等待樣片完成,透過取得影片任務狀態確認 status 為 completed。
  3. 提交成稿請求,帶上 draft_task_id 並填入第 1 步的樣片任務 ID,不要重複傳提示詞或素材。

階段對照

項目樣片(draft: true)成稿(draft_task_id)
支援的模型僅 seedance-2-5僅 seedance-2-5
resolution固定 480p固定 1080p
output_formatmp4mp4 或 mov
提示詞與素材與一般生成一致不接受,必須省略
樣片任務狀態要求-必須已成功完成
樣片任務有效期-自樣片建立起 7 天內
計費按 480p 檔費率結算按 1080p 檔費率結算;單價取決於樣片請求是否包含影片輸入

成稿必須與樣片使用相同的 model,且樣片所在渠道的樣片能力仍然可用。樣片任務未成功完成、建立已超過 7 天、模型不一致或渠道能力已關閉時,成稿會以 invalid_draft_task 失敗,需要重新生成樣片。

Body

draftboolean請求體預設值: false

設為 true 提交樣片請求。樣片按 480p 生成,其餘參數與一般生成一致。

僅支援 seedance-2-5;用於其他模型時返回 draft mode is only supported for Seedance 2.5。

draft_task_idstring請求體

成稿請求必填,填入樣片請求返回的任務 ID(tsk_vid_...)。

不能與 draft: true 同時使用。傳入 draft_task_id 後不得再傳 prompt、image_urls、image_with_roles、video_with_roles 或 audio_with_roles,否則返回 draft requests cannot include prompt or media。

resolutionstring請求體

樣片固定 480p,成稿固定 1080p。可以省略,省略時按對應階段的固定值生成;明確傳入其他值會被拒絕。

output_formatstring請求體預設值: mp4

僅成稿請求可指定,支援 mp4 和 mov。

return_last_frameboolean請求體預設值: false

成稿不會自動繼承樣片的尾幀設定。成稿也需要返回尾幀時,請在成稿請求中重新傳入 true。

prompt、duration、aspect_ratio、generate_audio、參考素材等其餘參數在樣片階段的使用方式與一般生成一致,詳見Seedance 2.5 影片生成。

請求範例

下面兩個範例分別是提交樣片和用樣片生成成稿的完整請求,可以依序執行。

請求示例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft": true,
    "prompt": "電影感產品特寫,鏡頭緩慢推進。",
    "duration": 4,
    "resolution": "480p",
    "return_last_frame": true
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-5",
    "draft_task_id": "tsk_vid_xxx",
    "resolution": "1080p",
    "output_format": "mp4",
    "return_last_frame": true
  }'

響應示例

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

計費

樣片和成稿分別計費,各自在任務完成時按上游實際 token 用量結算。樣片按 480p 檔費率結算;成稿按 1080p 檔費率結算,其 token 單價取決於樣片請求是否包含影片輸入:樣片請求帶了參考影片時,成稿按含影片輸入單價結算,輸入影片時長按樣片的原始輸入影片計算,樣片影片本身不計入;樣片請求沒有影片輸入時,成稿按不含影片輸入單價結算。實際扣費以任務結果和價格與實際費用為準。