创建视频
通过平台格式创建 Kling 4.0 文生、图生或 Omni 视频任务。
基础参数使用公共字段，高级输入通过 metadata.contents 提交，生成设置与回调、水印分别放在 metadata.settings 和 metadata.options 中。
/v1/video/generations使用平台公共字段创建视频，通过 metadata 配置文生、图生或 Omni 操作。
同时支持兼容路径 POST /v1/videos/generations，请求参数与主路径一致。
三种操作使用同一个 kling-4.0 模型；Omni 表示多参考能力，不是另一模型。
Authorization
bearerAuth 使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
使用 prompt 或 metadata.contents 提供提示词与素材；根据操作选择相应输入，不能将原生字段平铺到平台请求顶层。
Response Body
application/json
application/json
application/json
创建结果与查询
创建成功返回顶层任务对象，其中 id 与 task_id 是字符串形式的任务 ID。保存 task_id 后，通过 平台查询接口 获取状态和视频地址。
status: "queued" 表示任务已接收并排队，progress: 0 不代表生成失败；创建响应本身不包含最终视频地址。created_at 使用 Unix 秒时间戳，与原生响应中的毫秒时间戳不同。
选择输入方式
| 场景 | 输入方式 | 详细规则 |
|---|---|---|
| 文生视频 | prompt；高级配置指定 metadata.operation: "text-to-video" | 文生参数 |
| 图生视频 | image / images，或带类型的 metadata.contents；操作为 image-to-video | 图片来源与关键帧限制 |
| Omni 参考或编辑 | 使用 metadata.operation: "omni-video" 和 metadata.contents | 素材类型、引用与组合限制 |
显式填写 metadata.settings 时，其配置优先于快捷字段。图片、视频的素材引用 id 可选；元素和音色的引用 id 必填。无论使用哪种输入方式，填写的素材引用 ID 在同一任务中均不得重复。
常见错误与排查
| 响应或错误信息 | 检查与处理 |
|---|---|
HTTP 401，Invalid token | 检查 Authorization: Bearer your-api-key；使用请求站点对应的有效 API Key |
HTTP 400，模型名称不能为空 | 填写 model: "kling-4.0" |
HTTP 400，prompt cannot be empty | 文生请求需要非空 prompt；高级输入按对应原生操作填写 metadata.contents |
HTTP 400，duration must be an integer | 使用整数，例如 3，不要传字符串 "3" 或小数 |
settings.resolution ... is invalid | 将分辨率填写为 720p 或 1080p，不要填写像素尺寸；建议删除 size，统一使用 metadata.settings.resolution |
HTTP 400，invalid JSON request body | 检查引号、逗号和括号；请求体应是合法 JSON，不包含注释 |
HTTP 400 可能返回 code/message/data，也可能返回 error 对象。code: "fail_to_fetch_task" 在创建阶段也可能表示上游参数校验失败，请读取 message 中的具体原因，不要只根据该业务码反复重发。
message 可能是包含 code/message/request_id 的 JSON 字符串，不是已经解析的对象；可在确认格式后再解析。若需协助排查，请保留请求 ID，不要提供 API Key。具体输入限制参见对应原生操作，通用校验错误中的范围不代表模型能力。