LoopToken
视频生成

Kling 原生接口

可灵 4.0 / 3.0 / 3.0 Turbo 视频生成、动作控制、数字人、音效、对口型、多模态编辑、图像识别，路径与字段和可灵官方 API 一致

LoopToken 直接使用可灵官方 API 的路径、请求体和响应体。把官方示例里的域名换成 https://api.vibelab.me，把 Authorization 换成 LoopToken API Key，即可沿用官方文档和 SDK 的写法。

模型的可用状态以模型列表为准，精确价格以定价页为准。

认证与基础地址

项值
基础地址https://api.vibelab.me
认证Authorization: Bearer $LOOPTOKEN_API_KEY，所有接口使用同一个 API Key

Kling 4.0

视频生成与全能参考 · 主体管理 · 音色管理

4.0 使用 /text-to-video/kling-4.0、/image-to-video/kling-4.0、/omni-video/kling-4.0，支持 3–30 秒、720p/1080p。主体和音色管理使用 /v1/general/*。

接口清单

方法路径说明文档
POST/text-to-video/{model}文生视频文生视频
POST/image-to-video/{model}图生视频图生视频
POST/omni-video/kling-4.04.0 全能参考生成与视频编辑Kling 4.0
POST/motion-control/kling-3.0动作控制动作控制
GET/tasks查询任务（文生视频、图生视频、动作控制、全能参考）查询任务
POST/tasks按游标列出任务按游标列出任务
POST/v1/videos/avatar/image2video创建数字人任务创建数字人任务
GET/v1/videos/avatar/image2video/{id}查询数字人任务查询数字人任务
GET/v1/videos/avatar/image2video数字人任务列表数字人任务列表
POST/v1/audio/text-to-audio创建文生音效任务创建文生音效任务
GET/v1/audio/text-to-audio/{id}查询文生音效任务查询文生音效任务
GET/v1/audio/text-to-audio文生音效任务列表文生音效任务列表
POST/v1/videos/identify-face人脸识别（对口型前置步骤）人脸识别
POST/v1/videos/advanced-lip-sync创建对口型任务创建对口型任务
GET/v1/videos/advanced-lip-sync/{id}查询对口型任务查询对口型任务
GET/v1/videos/advanced-lip-sync对口型任务列表对口型任务列表
POST/v1/videos/multi-elements/init-selection初始化待编辑视频初始化待编辑视频
POST/v1/videos/multi-elements/add-selection增加视频选区增加视频选区
POST/v1/videos/multi-elements/delete-selection删减视频选区删减视频选区
POST/v1/videos/multi-elements/clear-selection清除视频选区清除视频选区
POST/v1/videos/multi-elements/preview-selection预览已选区视频预览已选区视频
POST/v1/videos/multi-elements创建多模态编辑任务创建多模态编辑任务
GET/v1/videos/multi-elements/{id}查询多模态编辑任务查询多模态编辑任务
GET/v1/videos/multi-elements多模态编辑任务列表多模态编辑任务列表
POST/v1/videos/image-recognize图像识别图像识别

两种接口风格：

  • 新版（文生视频、图生视频、动作控制、全能参考）：用 /tasks 查询，响应字段 id / status / succeeded。
  • 旧版（其余能力，官方的 /v1/... 接口）：各自有单个查询和分页列表，响应字段 task_id / task_status / succeed。

请按各接口页面的响应示例对接。

与官方的差别

  • 响应中不返回扣费信息：新版的 billing，旧版的 final_unit_deduction、final_balance_deduction。
  • external_task_id 在你的账号范围内去重。
  • callback_url 由 LoopToken 向你的地址投递。
  • 不支持 video_id、audio_id：它们指向可灵账号里的历史作品，不属于你的账号，请改用 video_url、sound_file。
  • session_id（人脸识别、视频初始化返回）只能由识别它的账号使用。

任务状态

风格状态取值
新版（3.0 系列、4.0、动作控制）submitted、processing、succeeded、failed
旧版（数字人、音效、对口型、多模态编辑）submitted、processing、succeed、failed

失败的任务不扣费。生成的视频、音频链接 30 天后会被清理，请及时转存。

回调

设置回调地址后，任务状态每次变化，LoopToken 会向该地址 POST 一份任务对象，结构与对应查询接口返回的单个任务相同。回调地址必须是公网 HTTPS，响应 2xx 视为投递成功，失败最多重试 3 次。

计费与预冻结

视频类接口按输出时长结算。提交任务时无法预知输出时长，所以会按该接口的时长上限预冻结额度，任务结束后按实际用量结算、多退少补；失败的任务全额退回。余额不足以预冻结时返回 403 / 1102。各接口的冻结口径见其页面的“计费”一节。

错误

错误响应与官方一致，结构为 { "code": ..., "message": "...", "request_id": "..." }。各接口页的“错误”一节只列本页特有的参数校验错误，以下是通用错误。

HTTPcode触发场景处理
4011000API Key 无效检查 Key
4031102insufficient credits（余额不足以预冻结），或 API key quota exceeded (settled usage)（Key 额度用完）充值，或调高 Key 额度
4291102video generation quota exceeded（账号的视频任务配额用完）联系管理员调整配额
4031103model not allowed for this key换有权限的 Key
4031304client IP not allowed for this key把调用方 IP 加入 Key 白名单
4291302user or API key request limit exceeded降低请求频率
4291303parallel task over limit（并发任务数超限，响应带 Retry-After）退避重试
4001201参数非法，message 给出具体字段按各接口页“错误”一节修正
4001201request body must be a JSON object请求体传 JSON 对象
4001201callback_url 不是公网 HTTPS 地址（如 callback_url must use https）改用公网 HTTPS 地址
4001201external_task_id already exists（同一账号下重复）换一个自定义任务 ID
4001201session_id not found（会话不属于当前账号）重新初始化或识别
4041203model not found（路径中的模型不存在）或 task not found（任务不存在或超过 30 天）核对路径与 ID
4001301内容触发安全策略（上游返回，message 透传）修改素材或提示词
5035001no compatible video channel is available、model sales price is not configured 或 upstream service temporarily unavailable稍后重试；持续出现请联系支持

上游返回 1200–1203、1300、1301 时，HTTP 状态、code、message 原样透传；返回 1302、1303 时转成 429 / parallel task over limit；其余上游错误统一返回 503 / 5001，不外露上游内部信息。

Omni Flash 系列

omni-flash-ext 与 gemini-omni-flash-preview：文生、参考视频驱动、图生与视频编辑，异步，按条计费，用 GET /v1/tasks/{task_id} 查询

Kling 4.0 视频生成

kling-4.0：文生视频、多关键帧图生视频、全能参考生成与视频编辑，3–30 秒、720p/1080p，异步，用 GET /tasks 查询

本页内容

认证与基础地址Kling 4.0接口清单与官方的差别任务状态回调计费与预冻结错误