seedance-2-5
seedance-2.5 flash 影片生成
使用 seedance-2-5-flash 模型生成影片
中國大陸用戶請注意: 中國大陸用戶請使用 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_KEYBody
modelstring請求體必填預設值: seedance-2-5-flashToAPIs 公共模型名稱,固定使用
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本次請求的模型名稱。
statusstringqueued、in_progress、completed 或 failed。progressinteger0–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}