图生视频
使用首帧、首尾帧或多个关键帧生成 Kling 4.0 视频。
通过 contents 组合提示词与关键帧，每次任务最多输入 10 张图片。此接口不提供 aspect_ratio，请使用符合目标画幅的参考图片。
POST
/kling/image-to-video/kling-4.0使用首帧、首尾帧或多个关键帧生成视频，每次任务最多输入 10 张图片。画幅沿用参考图，不提供 aspect_ratio 参数。
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
图片与引用规则
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。