AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
影片生成Kling

文生影片

使用 Kling 4.0 原生結構提交文字影片生成任務。

提示詞可以同時包含希望出現和避免出現的內容。使用 settings 控制時長、解析度和畫面比例,使用 options 設定回呼及水印。

POST/kling/text-to-video/kling-4.0

使用提示詞生成 Kling 4.0 影片。模型由路徑指定,請求體不需要填寫 model。

授權

bearerAuth
授權Bearer <token>

使用平台 API Key:Authorization: Bearer your-api-key。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

回應主體

application/json

application/json

application/json

常見錯誤與排查

回應或錯誤資訊檢查與處理
HTTP 401,Invalid token檢查 Bearer 驗證格式及 API Key 是否屬於請求站點
HTTP 400,prompt cannot be empty提供非空的文字提示詞
HTTP 400,prompt value type is invalidprompt 必須是字串,不是數組或物件
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。