跳轉到主要內容

快速開始

影片生成是非同步操作,整個流程分為三步:
最簡範例

介面總覽

Base URL:https://aihubmix.com 認證方式:Bearer Token

支援的模型

文生影片(Text-to-Video)

圖生影片(Image-to-Video)

圖生影片需透過 input_reference 參數傳入參考圖片(阿里通義萬相);豆包 Seedance 透過 extra_body.content 陣列傳入,支援圖片、影片、音訊多種參考類型;可靈 Kling 使用 image / image_tail / image_list 傳圖,詳見下方可靈 Kling 小節。

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 效果更佳。

即夢 AI

支援的寬高比與對應解析度 範例

豆包 Seedance

extra_body.content 支援的引用類型 範例
Seedance 2.0 / 2.0 Fast

可靈 Kling

可靈(Kling)支援 文生影片、圖生影片、多圖參考生影片、OmniVideo 多模態 四類能力,統一透過 /v1/videos 介面呼叫,閘道按「模型名 + 輸入形態」自動路由到可靈對應端點,無需呼叫方區分。 參數
不支援或未對應的關鍵參數會明確報錯,不會靜默丟棄。其餘可靈原生參數可放進 extra_body 透傳到上游。
範例
說明
  • 非同步三步:提交取得 video_id → 輪詢 GET /v1/videos/{video_id}statuscompletedGET /v1/videos/{video_id}/content 下載 MP4。狀態值:in_progress / completed / failed
  • 出片通常 1~3 分鐘;結果影片 URL 30 天後清理,請及時轉存。
  • 刪除任務:可靈無刪除介面,DELETE /v1/videos/{video_id} 回傳 501 not_supported
  • 計費:按 模型 × mode × 時長 × 能力(有無參考影片 / 有聲)扣費;生成失敗不扣費,查詢與下載不計費。

完整呼叫範例

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