Skip to main content
新接入建議使用 影片生成 與統一 /ai/v1/videos 協定。本頁 /v1/videos 相容介面及模型適配仍可使用。呼叫前請查詢 模型 Schema 介面,依回傳的 path 選擇協定並讀取該項的 request.schema,不要依賴陣列位置。

目前模型清單

本清單表示模型目前已上線,不代表所有模型共用相同輸入欄位。請依模型 Schema 回傳的 path 選擇端點,再讀取該項的 request.schema

API 詳細說明

請求標頭

建立影片生成任務

請求主體

不同模型的回應格式略有差異,但都包含 id(video_id)和 status 欄位。以 status 判斷任務進度即可。

回應範例(通義萬相/Veo/即夢AI

回應範例(Sora)

通用狀態值說明

查詢影片狀態

輪詢此介面檢查任務是否完成。建議每 15 秒 查詢一次。

回應範例(生成完成 - 通義萬相)

回應範例(生成完成 - 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 中描述聲音,如「鳥鳴聲」、「鋼琴旋律」

任務失敗怎麼處理?

statusfailed 時,回應中的 error 欄位會包含錯誤資訊:

常見失敗原因包括:內容違規、prompt 過長、圖片格式不支援等。請根據錯誤資訊調整後重試。

更新時間:2026-06-01