模型名称kling-v3-omni 使用 POST /v1/videos 提交、GET /v1/videos/{task_id} 查询。支持文生、图片引用、视频编辑、元素引用与多镜头。 不支持 audio_urls、草稿、任务链和回调字段。

请求鉴权

所有接口均使用 Bearer Token 鉴权。

提交任务接口

提交时请使用本页参数表中已列出的字段;未列出的模型私有字段不能作为公共协议传入。

最小请求示例

提交受理成功后会立即返回任务,不代表视频已经生成完成:
参数不符合本页约束时,接口会返回 HTTP 400:

任务查询接口

使用提交响应中的 id 替换 {task_id} 轮询任务;完成后从 url 取得视频文件:

异步状态与失败响应

视频任务状态只使用 queuedin_progresscompletedfailed。处于 queuedin_progress 时继续调用查询接口;只有 completed 状态才读取顶层 result_url 任务失败时保持视频对象结构,并返回顶层 errorfail_reason,不要按图片接口读取 code/data/works

使用说明

  1. 先以最小请求验证鉴权与任务提交,再按本页参数表增加时长、画面规格或参考素材。
  2. 任务处于 queuedin_progress 时请继续查询;只有 completed 状态才表示可以读取 result_url
  3. 参考素材必须是调用方可访问的 URL,并遵守本页给出的数量和组合限制。