ToAPIsToAPIs
seedance-2-5

seedance-2.5 flash 影片生成

使用 seedance-2-5-flash 模型生成影片

POST
/v1/videos/generations

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

Seedance 2.5 flash 是 Seedance 2.5 的輕量快速版,公共模型名稱為 seedance-2-5-flash。

  • 支援文生影片、首幀/首尾幀圖生影片、影片編輯、影片延長及多模態參考生影片。
  • 支援圖片、影片和音訊參考,也支援純音訊參考。
  • 介面採用非同步任務;提交後返回 generation.task,完成後透過任務狀態介面取得影片。

與 Seedance 2.5 相比,flash 生成速度約提升一倍,價格更低,僅輸出 480p 或 720p,參考素材上限為 20 個(圖片 10 張、影片 5 段、音訊 5 段),不支援樣片模式。

Authorizations

Authorizationstring請求頭必填

所有請求都需要 Bearer Token。請在 API Key 管理頁面 取得金鑰,並加入:

Authorization: Bearer YOUR_API_KEY

Body

modelstring請求體必填預設值: seedance-2-5-flash
ToAPIs 公共模型名稱,固定使用 seedance-2-5-flash。
promptstring請求體
描述場景、鏡頭運動、主體動作、風格與聲音氛圍。引用素材時使用「圖片1」「影片1」「音訊1」等標籤。
video_operationstring請求體預設值: generate
視頻業務類型:generate、edit 或 extend。編輯和延長至少需要一個 video_with_roles;編輯使用 duration=-1,延長使用 4–30 或 -1。三種操作共用此接口。
client_business_idstring請求體
客戶側訂單號或業務任務 ID。可用 GET /v1/videos/generations/{client_business_id} 查詢。
durationinteger請求體
輸出影片時長(秒),範圍為 4–30;-1 表示由模型自動選擇時長。編輯任務只能使用 -1,輸出時長與輸入影片基本一致;延長任務可使用 4–30 或 -1,此時按延長後的輸出總時長計算。
aspect_ratiostring請求體
可選 21:9、16:9、4:3、1:1、3:4、9:16、adaptive。編輯、延長和首尾幀任務按上游要求使用 adaptive。
image_urlsstring[]請求體
相容模式圖片 URL 陣列。新接入建議使用 image_with_roles;兩個欄位不能同時傳送。
image_with_rolesarray請求體
帶角色的圖片陣列,每項含必填 url 和 role。角色可為 first_frame、last_frame 或 reference_image,最多 10 張。首尾幀模式與參考圖模式不可混用。
video_with_rolesarray請求體
參考影片陣列,每項含 url,角色固定為 reference_video,最多 5 段。
audio_with_rolesarray請求體
參考音訊陣列,每項含 url,角色固定為 reference_audio,最多 5 段;支援純音訊參考。
resolutionstring請求體
解析度:480p 或 720p。Seedance 2.5 flash 不支援 1080p 和 4k。
output_formatstring請求體預設值: mp4
支持 mp4 和 mov。
generate_audioboolean請求體預設值: true
是否生成同步音訊。
return_last_frameboolean請求體預設值: false
是否在完成結果中返回生成影片的尾幀圖片。
toolsarray請求體
可選工具:[{ "type": "web_search" }]。僅適用純文生影片,不能與圖片、影片或音訊輸入同時使用。
callback_urlstring請求體
ToAPIs 任務完成回呼地址,詳見任務 Webhook。
trace_idstring請求體
呼叫方自訂的鏈路追蹤 ID。
disable_nsfwboolean請求體預設值: true
默認禁止生成 NSFW 內容。顯式設為 false 時允許。

參考素材限制

最多共 20 個參考素材:圖片 10 張、影片 5 段、音訊 5 段。請使用明確角色,避免首幀/尾幀與參考素材被錯誤推斷。

非法任務組合可能失敗。編輯和延長任務會明確指定上游任務類型,特殊限制不符合時在提交階段立即返回錯誤;其餘任務類型由模型按素材和提示詞判斷,不符合時在異步階段失敗並返回 InvalidParameter.TaskTypeConstraint。編輯、延長和首尾幀任務按上游要求將 aspect_ratio 設為 adaptive。

素材審核

請求帶有圖片, 影片或音訊素材時, 部分渠道會在提交生成前自動審核素材. 無需額外參數, 在原有媒體欄位中傳入素材 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.

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

Response

idstring
任務 ID,用於查詢狀態。
client_business_idstring
請求傳入此欄位時返回。
objectstring
固定為 generation.task。
modelstring
本次請求的模型名稱。
statusstring
queued、in_progress、completed 或 failed。
progressinteger
0–100 的任務進度。
created_atinteger
建立時間戳。

請求示例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"seedance-2-5-flash","prompt":"電影感產品特寫,鏡頭緩慢推進。","duration":10,"aspect_ratio":"16:9","resolution":"720p","generate_audio":true}'
{
  "model": "seedance-2-5-flash",
  "prompt": "向後延長影片1,鏡頭繼續推進並展示窗外的城市。",
  "video_operation": "extend",
  "duration": 11,
  "aspect_ratio": "adaptive",
  "output_format": "mov",
  "video_with_roles": [{"url": "https://example.com/source.mov", "role": "reference_video"}]
}

響應示例

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