圖生影片
使用首幀、首尾幀或多個關鍵幀生成 Kling 4.0 影片。
透過 contents 組合提示詞與關鍵幀，每次任務最多輸入 10 張圖片。此API不提供 aspect_ratio，請使用符合目標畫幅的參考圖片。
POST
/kling/image-to-video/kling-4.0使用首幀、首尾幀或多個關鍵幀生成影片，每次任務最多輸入 10 張圖片。畫幅沿用參考圖，不提供 aspect_ratio 參數。
圖片與引用規則
contents 中可使用 first_frame（首幀）、middle_frame（中間幀）和 last_frame（尾幀）；提示詞項 type: "prompt" 選用。右側提供首幀、首尾幀和多關鍵幀三種請求範例。
| 項目 | 要求 |
|---|---|
| 圖片來源 | url 必填，支援 URL 或 Base64 |
| 圖片格式與大小 | JPG、JPEG、PNG；每張不超過 30MB |
| 圖片尺寸 | 寬高均不少於 300px，長寬比介於 2:5 與 5:2 |
| 圖片數量 | 每次任務最多 10 張 |
| 素材引用 ID | id 選用；填寫時，同一任務中不得重複 |
需要在提示詞中指明某張圖片時，可為此圖片設定 id，例如 "id": "first" 對應 @first。id 是本次請求內的引用標識，不是生成後回傳的任務 ID。
常見錯誤與排查
| 回應或錯誤資訊 | 檢查與處理 |
|---|---|
HTTP 401，Invalid token | 檢查 Bearer 驗證格式及 API Key 是否屬於請求站點 |
HTTP 400，contents cannot be empty | 提供非空的 contents 數組 |
HTTP 400，contents must contain at least one of first_frame, middle_frame, last_frame | 至少提供一項關鍵幀圖片，僅有提示詞不能用於圖生 |
HTTP 400，must have a non-blank url | 為對應關鍵幀填寫非空 url |
HTTP 400，contents[0].type ... is invalid | 檢查指定索引的素材類型，使用本頁支援的關鍵幀或提示詞類型 |
HTTP 400，invalid_request 或 invalid JSON request body | 檢查 JSON 語法與欄位類型；contents 必須是數組，不是字串 |
HTTP 400 可能回傳 code/message/data 或 error 物件。fail_to_fetch_task 不一定是任務查詢錯誤，請檢視 message 中的素材校驗原因；此欄位可能是 JSON 字串，不是已經解析的物件。排查時保留請求 ID，不要提供 API Key。