LoopToken
视频生成Kling 原生接口

图生视频

POST /image-to-video/{model}：可灵 3.0 / 3.0 Turbo 图生视频，异步，用 GET /tasks 查询

POST/image-to-video/{model}

用首帧（可选尾帧、主体）和提示词生成视频。

项值
模型kling-3.0-turbo / kling-3.0
模式异步（提交 → 轮询 GET /tasks，见查询任务）
计费按输出视频时长（秒）结算

快速开始

curl https://api.vibelab.me/image-to-video/kling-3.0 \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "女孩坐在火车上望向窗外，神情忧郁"
      },
      {
        "type": "first_frame",
        "url": "https://example.com/start.jpg"
      },
      {
        "type": "last_frame",
        "url": "https://example.com/end.jpg"
      }
    ],
    "settings": {
      "resolution": "1080p",
      "duration": 10,
      "audio": "native"
    }
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080778802,
    "external_id": "your-id"
  }
}

请求参数

请求头

参数类型必填默认说明
Authorizationstring是-Bearer $LOOPTOKEN_API_KEY
Content-Typestring是-application/json

路径参数

参数类型必填默认说明
modelstring是-kling-3.0-turbo 或 kling-3.0

请求体

参数类型必填默认说明
contentsarray是-素材数组，元素见下
contents[].type=promptobject否-提示词，字段 text，不超过 3072 个字符
contents[].type=first_frameobject是-首帧图，字段 url（公网 URL 或 Base64），必须有
contents[].type=last_frameobject否-尾帧图，字段 url；仅 kling-3.0，须与 first_frame 同时传
contents[].type=elementobject否-主体引用，字段 element_id 和 id，最多 3 个；仅 kling-3.0
settings.resolutionstring否720p同文生视频
settings.durationinteger否53–15 秒
settings.audiostring否off仅 kling-3.0：native 或 off
options.callback_urlstring否-任务状态变化时的 HTTPS 回调地址，见概览
options.external_task_idstring否-自定义任务 ID，同一账号下不可重复
options.watermark_info.enabledboolean否false是否同时生成含水印结果

响应

字段类型说明
codeinteger0 表示成功，其余见错误
messagestring错误信息
request_idstring请求 ID，排查问题时提供
data.idstring任务 ID
data.statusstringsubmitted、processing、succeeded、failed
data.create_time、data.update_timeintegerUnix 毫秒时间戳
data.external_idstring创建时传入的 options.external_task_id，没传则无此字段

计费

按输出视频时长（秒）结算；任务失败全额退回。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTPcode触发场景处理
4041203model not found（路径 {model} 不是已上架的可灵模型）路径写 kling-3.0-turbo 或 kling-3.0
4001201contents is required and must be a non-empty array传非空 contents 数组
4001201contents must include a first_frame补一项 first_frame
4001201unsupported contents type "..." for ...只接受 prompt、first_frame、last_frame、element；kling-3.0-turbo 不接受 last_frame、element
4001201at most 3 elements are supportedelement 不超过 3 个
4001201prompt must not exceed 3072 characters缩短提示词
4001201settings.resolution "..." is not supported for ...同文生视频
4001201settings.duration must be between 3 and 15传 3–15 的整数
4001201settings.audio "..." is not supported for ...kling-3.0 只接受 native/off；kling-3.0-turbo 不能传

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

  • 图片格式 → 支持 jpg、jpeg、png，宽高不小于 300px，宽高比在 1:2.5 到 2.5:1 之间。

文生视频

POST /text-to-video/{model}：可灵 3.0 / 3.0 Turbo 文生视频，异步，用 GET /tasks 查询

动作控制

POST /motion-control/kling-3.0：用参考视频的动作驱动参考图中的人物，异步，用 GET /tasks 查询

本页内容

快速开始请求参数请求头路径参数请求体响应计费错误注意事项