新接入建議使用 影片生成 與統一
/ai/v1/videos 協定。本頁 /v1/videos 相容介面及模型適配仍可使用。呼叫前請查詢 模型 Schema 介面,依回傳的 path 選擇協定並讀取該項的 request.schema,不要依賴陣列位置。目前模型清單
本清單表示模型目前已上線,不代表所有模型共用相同輸入欄位。請依模型 Schema 回傳的
path 選擇端點,再讀取該項的 request.schema。API 詳細說明
請求標頭
建立影片生成任務
請求主體
不同模型的回應格式略有差異,但都包含id(video_id)和status欄位。以status判斷任務進度即可。
回應範例(通義萬相/Veo/即夢AI)
通用狀態值說明
查詢影片狀態
回應範例(生成完成 - 通義萬相)
回應範例(生成完成 - Sora)
所有模型均透過status == "completed"判斷完成狀態,然後呼叫/content介面下載。
下載影片內容
completed 後,呼叫此介面下載 MP4 影片檔案。
回應: 直接回傳影片二進位串流(Content-Type: video/mp4)。
注意:影片下載連結通常有 24 小時有效期,請及時下載儲存。
刪除影片任務
此介面用於刪除已建立的影片任務。各模型參數詳解
OpenAI Sora
提示:所有模型的範例seconds參數統一使用字串類型傳入(如"8")。
Google Veo
範例
圖片欄位說明:
- 首幀優先級:
first_frame>input_reference(OpenAI 相容單幀)。 first_frame/last_frame/reference_images每個元素均支援:公網 URL、base64 dataURL(data:image/png;base64,...)、或{"mime_type":"image/png","data":"<base64>"}物件。- 也相容 OpenRouter 風格的
frame_images(元素帶frame_type: first_frame | last_frame)與input_references別名。 - 參考圖最多 3 張,超出返回 400。
提示:Veo 支援原生音訊生成,可在 prompt 中描述音效,如「背景傳來鳥鳴聲」、「鋼琴旋律」。
通義萬相
各模型支援的時長
支援的解析度(寬*高)
注意:wan2.6 僅支援 720P 和 1080P;wan2.5 支援 480P、720P、1080P;wan2.2 僅支援 480P 和 1080P。範例
提示:wan2.5 及以上版本預設生成有聲影片(自動配音),中文 prompt 效果更佳。
豆包 Seedance
使用真人素材前,請先完成素材組建立、本人確認和素材入庫,已有相容用戶端可直接參考真人素材相容協定範例。extra_body.content 支援的引用類型
範例
Seedance 2.0 / 2.0 Fast
Kling
本清單表示模型目前已上線,不代表所有模型共用相同輸入欄位。請依模型 Schema 回傳的
path 選擇端點,再讀取該項的 request.schema。完整呼叫範例
FAQ
影片生成需要多長時間?
影片生成通常需要 1-5 分鐘,具體時間取決於模型、解析度和時長。建議設定 15 秒的輪詢間隔。input_reference 參數怎麼用?
input_reference 用於圖生影片場景,支援三種傳入方式:
影片下載連結有效期是多久?
生成的影片下載連結通常有 24 小時 有效期,請及時下載儲存。各模型seconds 參數有什麼區別?
> 提示:所有模型的
seconds 參數統一使用字串類型傳入(如 "8"),API 會自動處理。
不同模型size 參數格式有什麼區別?
###
seconds 和 duration 有什麼區別?
兩者含義相同,均表示影片時長。API 同時支援這兩個參數名(Sora 除外,Sora 只接受 seconds)。推薦統一使用 seconds。
如何撰寫更好的 prompt?
- 描述具體場景:包含主體、動作、環境、光線、氛圍
- 指定鏡頭語言:如「特寫」、「航拍」、「推鏡頭」、「慢動作」
- 描述風格:如「電影感」、「紀錄片風格」、「動畫風格」
- 中文模型用中文 prompt 效果更好:通義萬相針對中文最佳化
- Veo 支援音訊描述:可在 prompt 中描述聲音,如「鳥鳴聲」、「鋼琴旋律」
錯誤回應與相容錯誤碼
本節適用於本頁的 Legacy/v1/videos/* 介面。新版 /ai/v1/videos/* 使用獨立的
影片錯誤合約。兩套介面的回應結構和
錯誤碼需要分別處理。
Legacy 影片介面的一般 HTTP 錯誤回應如下。一般錯誤通常不會回傳 code 和 param,
tid 通常附加在 message 末尾:
提交 HTTP 5xx 錯誤回饋
僅在請求回傳 HTTP
5xx 時提交回饋,並附上 message 中的 tid。HTTP 200 + status=failed
查詢請求成功時 HTTP 狀態仍可能是 200。影片任務為 failed 時,error 包含模型推理廠商
提供的動態 message,一般任務失敗沒有穩定 code:
更新時間:2026-09-01