Kling 视频生成

可灵原生协议经统一视频入口提交,按可灵官方任务体轮询

POST/v1/videos

可灵(Kling)系列模型经统一视频入口 POST /v1/videos 提交:请求体为可灵官方字段 + model(模型名以 kling 开头即路由到可灵,兼容 model_name 字段),响应与查询均为可灵官方任务体,平台透明转发不改字段。可用模型名以 列出模型 返回为准(如 kling-v1、kling-v2-master 等)。

Authorizations

Authorizationstring必填

Bearer Token 认证,无需自行签发可灵 JWT——平台代签。 获取 API Key:访问 API Key 管理页面

Authorization: Bearer YOUR_API_KEY

提交生成任务

POST /v1/videos

请求体 = 可灵官方参数 + model:

  • model(必填):kling 开头的模型名(决定路由到可灵;文生 / 图生由是否携带 image 自动分派)
  • prompt、negative_prompt、mode(std / pro)、duration、aspect_ratio、cfg_scale、image(图生视频首帧)、image_tail 等——字段与取值以可灵官方文档为准

查询任务

GET /v1/videos/{task_id}

响应为可灵官方任务体,data.task_status 枚举:submitted / processing / succeed / failed。成功后生成结果在 data.task_result.videos[](含 url 与时长),视频 URL 有效期以可灵官方为准,请及时转存。

注意事项

  • 任务查询必须使用提交时所用的同一个 API Key;任务 Id 可查询窗口 7 天,过期返回 404 task_not_found
  • 提交返回 HTTP 200 但 code≠0 表示可灵业务错误(如参数校验、内容审核),不会产生费用,请按 message 排查
  • 请求与响应字段完整定义以可灵官方文档为准,平台不做字段改写