文生视频
使用 Kling 4.0 原生结构提交文本视频生成任务。
提示词可以同时包含希望出现和避免出现的内容。使用 settings 控制时长、分辨率和画面比例，使用 options 配置回调及水印。
POST
/kling/text-to-video/kling-4.0使用提示词生成 Kling 4.0 视频。模型由路径指定，请求体不需要填写 model。
Authorization
bearerAuth AuthorizationBearer <token>
使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response 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 invalid | prompt 必须是字符串，不是数组或对象 |
HTTP 400，invalid_request | 检查 settings.duration 等字段的类型；时长必须是整数 |
| HTTP 400，分辨率或比例校验错误 | 按本页枚举填写 settings.resolution 和 settings.aspect_ratio |
HTTP 400，invalid JSON request body | 检查 JSON 语法，不要在请求体中保留注释 |
部分错误来自通用校验层，其文字中可能出现比模型实际开放范围更宽的取值。本接口仍按本页字段表使用 3～30 秒整数、720p 或 1080p，不能仅根据错误信息推断支持其他时长或分辨率。
创建失败时可能返回 code/message/data 或 error 对象，不一定沿用成功响应结构。fail_to_fetch_task 的具体原因在 message 中；该字段可能是包含 code/message/request_id 的 JSON 字符串。请保留请求 ID 以便排查，不要提供 API Key。