POST
Kling 官方接口

简介

Kling 官方接口以可灵官方 API 风格提供文生视频、图生视频与 Omni(多参考输入)能力,通过 可灵 Kling 或腾讯 TokenHub 渠道分发。共有两套入口:
  • V1 风格/kling/v1/videos/...,模型写在请求体里;
  • 3.0 官方风格/kling/text-to-video/kling-3.0 等,模型在 URL 路径里,查询使用 GET /kling/tasks

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

Kling V1 风格

支持模型(V1)

提交任务(V1)

POST /kling/v1/videos/text2video/kling/v1/videos/image2video

文生视频

图生视频

更专业参数(负向提示词、画幅比例、音频等)通过 metadata 透传:

请求参数(V1)

提交响应(V1)

任务接受后返回视频任务对象(task_id 用于查询):

查询任务(V1)

GET /kling/v1/videos/text2video/{task_id}(或 image2video):
status 取值语义: 成功时响应内包含视频地址(或通过 内容获取 接口取视频文件),任务耗时通常在数分钟。

Kling 3.0 官方风格

模型标识在 URL 路径中,请求体其余字段(含未知字段)原样透传。

支持模型(3.0)

提交任务(3.0)

POST /kling/text-to-video/kling-3.0(或按场景选择 image-to-video / omni-video):

请求参数(3.0)

其他未列出的字段(如 seed、画幅等)会原样透传给上游。

Omni 输入限制

  • 最多 1 个参考视频
  • 无参考视频时,参考图等输入最多 7 个
  • 有参考视频时,参考输入最多 4 个

查询任务(3.0)

GET /kling/tasks?task_ids={task_id}(或 external_task_ids=),一次只支持查询一个任务:
官方响应 envelope:
data[].status 取值:submittedprocessingsucceededfailed。失败时 data[].error 携带 code/message;时间为 Unix 毫秒。

回调(3.0)

服务端通过 options.callback_url 配置后,会在任务状态变化时向你的回调地址发送通知。回调以 HMAC 签名保护,无 Token 鉴权,请求体为 application/json(≤1 MiB):
收到回调后请返回 {"code": 0, "message": "success"} 确认;返回 5xx 会触发上游重试。

相关页面

视频生成总览

异步流程与入口选择

视频内容获取

下载与代理获取视频文件