Omni 影片生成
使用多種參考素材生成或編輯 Kling 4.0 影片。
feature_video 用於參考影片的特征與運動節奏，base_video 用於編輯已有影片。圖片、影片、元素和音色合計最多 15 項，並需同時滿足各類素材限制；元素與音色使用已有 ID，本頁不包含素材管理API。
POST
/kling/omni-video/kling-4.0組合提示詞、圖片、影片、元素和音色生成或編輯影片。feature_video 用於影片參考，base_video 用於編輯；Omni 與其他兩個生成端點使用同一個 Kling 4.0 模型。
素材類型與引用
contents 必須包含提示詞項 type: "prompt"，其他素材按需添加。id 用於提示詞中的 @reference；所有填寫的素材引用 ID 在同一任務中不得重複。
| 素材 | type | 來源與必填要求 |
|---|---|---|
| 圖片 | first_frame / middle_frame / last_frame / refer_image | url 必填，支援 URL 或 Base64；id 選用 |
| 影片 | feature_video / base_video | url 必填，使用影片 URL；id 選用 |
| 元素 | element | element_id 與 id 均必填 |
| 音色 | voice | voice_id 與 id 均必填 |
element_id 是系統生成的元素 ID，可透過元素相關 API 查詢；voice_id 是音色 ID，自訂音色透過自訂音色 API 取得，也可使用官方說明中的系統預設音色。它們與本次請求的素材引用 id 不是同一個參數。
元素的概念與使用方式請參閱 官方元素庫指南，音色來源請參閱 官方音色自訂說明。請使用對應區域的素材 ID，不要直接沿用其他區域的預設 ID。
素材限制
| 素材 | 格式與大小 | 尺寸、時長與數量 |
|---|---|---|
| 圖片 | JPG、JPEG、PNG；每張不超過 30MB | 寬高均不少於 300px；長寬比 2:5～5:2；最多 10 張 |
| 影片 | MP4、MOV；單檔案不超過 300MB | 每段及輸入影片總時長均為 3～30 秒；寬高 700～4553px，總像素不超過 8294400；長寬比 2:5～5:2；輸入 24～60fps，輸出 24fps |
| 元素 | 多圖元素或影片角色元素 | 最多 7 個，其中影片角色元素最多 3 個 |
| 音色 | 已有自訂音色或系統預設音色 | 最多 3 個 |
組合素材時還需同時滿足：
- 圖片、影片、元素和音色合計不超過 15 項。
- 影片與影片角色元素合計不超過 5 項，
base_video最多 1 段。 - 輸入影片總時長包括
feature_video、base_video和影片角色元素的源影片時長。
常見錯誤與排查
| 回應或錯誤資訊 | 檢查與處理 |
|---|---|
HTTP 401，Invalid token | 檢查 Bearer 驗證格式及 API Key 是否屬於請求站點 |
HTTP 400，contents cannot be empty | 提供非空的 contents 數組 |
HTTP 400，prompt cannot be empty | 在 contents 中加入 type: "prompt" 的非空文字項 |
HTTP 400，contents[0].type ... is invalid | 按本頁枚舉填寫素材類型，並檢查报錯索引對應的項 |
HTTP 400，Invalid element id | 檢查 element_id，不要用本次素材引用 id 代替元素 ID |
HTTP 400，Invalid voice id | 檢查 voice_id，不要用本次素材引用 id 代替音色 ID |
HTTP 400，invalid JSON request body | 檢查 JSON 的引號、逗號、括號與註釋 |
HTTP 400 可能回傳 code/message/data 或 error 物件。fail_to_fetch_task 的實際原因在 message 中；此欄位可能是包含 code/message/request_id 的 JSON 字串。請保留請求 ID 以便排查，不要提供 API Key。