POST https://api.mixroute.ai/v1/video/generations
model、prompt 和 asset 放在請求頂層,廠商參數放在 metadata。純文字請求使用 asset: false,並在 metadata.content 傳入與 prompt 一致的文字項目。傳入參考素材時使用 asset: true。
Flash 不支援 Draft。省略
metadata.draft,也不要傳 draft_task 內容項目。需要草稿預覽時,請使用標準版 Doubao Seedance 2.5 路由。參數與限制
輸入模式
- 首幀生成影片使用
first_frame;首尾幀生成影片使用first_frame和last_frame。metadata.ratio必須設為adaptive。不要混用影格角色和reference_*角色。 - 全模態參考使用
reference_image、reference_video或reference_audio。每次最多 10 張圖片、5 段影片和 5 段音訊,支援僅傳音訊參考。參考影片總時長和參考音訊總時長各不超過 30 秒。 - 影片編輯須傳入一段 4–30 秒的
reference_video,將metadata.ratio設為adaptive,metadata.duration設為-1。延長影片同樣須傳入reference_video並使用adaptive。
請求範例
將MIXROUTE_API_KEY 設為 MixRoute API Key。執行編輯範例前,將範例網址換成可存取的來源影片。
文字生成影片
編輯影片
查詢任務
將MIXROUTE_TASK_ID 換成提交請求回傳的任務 ID,待任務成功後再讀取影片 URL。狀態和回傳欄位詳見查詢影片任務。