文生影片
使用 Kling 4.0 原生結構提交文字影片生成任務。
提示詞可以同時包含希望出現和避免出現的內容。使用 settings 控制時長、解析度和畫面比例,使用 options 設定回呼及水印。
常見錯誤與排查
| 回應或錯誤資訊 | 檢查與處理 |
|---|---|
HTTP 401,Invalid token | 檢查 Bearer 驗證格式及 API Key 是否屬於請求站點 |
HTTP 400,prompt cannot be empty | 提供非空的文字提示詞 |
HTTP 400,prompt value type is invalid | prompt 必須是字串,不是數組或物件 |
HTTP 400,invalid_request | 檢查 settings.duration 等欄位的類型;時長必須是整數 |
| HTTP 400,解析度或比例校驗錯誤 | 按本頁枚舉填寫 settings.resolution 和 settings.aspect_ratio |
HTTP 400,invalid JSON request body | 檢查 JSON 語法,不要在請求體中保留註釋 |
部分錯誤來自通用校驗層,其文字中可能出現比模型實際開放範圍更寬的取值。本API仍按本頁欄位表使用 3~30 秒整數、720p 或 1080p,不能僅根據錯誤資訊推斷支援其他時長或解析度。
建立失敗時可能回傳 code/message/data 或 error 物件,不一定沿用成功回應結構。fail_to_fetch_task 的實際原因在 message 中;此欄位可能是包含 code/message/request_id 的 JSON 字串。請保留請求 ID 以便排查,不要提供 API Key。