可灵 3.0（Kling 3.0）是快手可灵的新一代视频生成模型，提供标准版 kling-3.0、极速版 kling-3.0-turbo 与多模态版 kling-3.0-omni 三档视频能力，覆盖文生视频、图生视频（首帧 / 尾帧 / 首尾帧）与 Omni 多模态融合生成（参考图 / 参考视频 / 主体元素）；并在此之上扩展了动作控制 kling-3.0-motion-control、数字人 kling-3.0-avatar 与声音复刻 kling-3.0-voice 三个专用能力，共 6 个模型。LoopRouter 以对标可灵官方 3.0 的路径式接口对外提供：视频生成走 /text-to-video/{model}、/image-to-video/{model}、/omni-video/{model}，动作控制走 /motion-control/{model}，数字人走 /videos/avatar/image2video，声音复刻走 /general/custom-voices；视频任务查询走 GET /tasks，数字人与声音复刻各有专属查询端点；Base URL 换成 https://api.looprouter.com、鉴权换成 LoopRouter 令牌即可。
可灵 3.0 是路径式接口（模型名在 URL 路径里，如 /text-to-video/kling-3.0），请求体用 settings / options / contents。所有端点的路径都可选加 /v1 前缀（如 /v1/text-to-video/kling-3.0），行为完全一致，方便 Base URL 带 /v1 的可灵 SDK 直接接入；不加前缀是默认形态。它与旧版 body 式的 /kling/v1 接口是两套独立的 API，请勿混用。

​
快速入口

视频生成 API

文生视频、图生视频、Omni 多模态与任务查询

在线调试（试一试）

在文档内直接对可灵 3.0 端点发起真实请求

获取 API Key

在控制台创建 sk- 令牌

​
核心特性

六个模型

视频三档 kling-3.0 / kling-3.0-turbo / kling-3.0-omni，外加动作控制、数字人、声音复刻

Omni 多模态融合

/omni-video 统一处理参考图、参考视频、基准视频与主体元素

动作控制 / 数字人 / 声音复刻

参考视频驱动动作、音频驱动人像口型、音源克隆音色（voice_id 可回填数字人）

路径式原生接口

对标可灵官方 3.0 路径式 API，已有示例替换 Base URL 与令牌即可运行

​
模型清单

前三个视频模型的模型名写在 URL 路径中（/text-to-video/kling-3.0），任务类型由调用的端点决定：kling-3.0 与 kling-3.0-turbo 走文生 / 图生端点，多模态融合用 kling-3.0-omni 走 /omni-video。动作控制、数字人、声音复刻是专用端点，计费模型由端点自动绑定：动作控制支持官方 contents / settings 或扁平结构两种请求形态（并存时以 contents / settings 优先），数字人与声音复刻请求体为扁平结构。

​
技术规格

Omni 素材（first_frame / last_frame / refer_image / feature_video / base_video / element）与文本一起放在 contents 数组里；网关会按顺序把每个素材绑定进提示词，无需手动书写占位符。数量与组合限制以模型档位为准。

​
端点一览

Base URL：https://api.looprouter.com
所有接口统一使用 Authorization: Bearer sk-... 请求头，API Key 在 控制台 → 令牌 创建。以上路径均可选加 /v1 前缀（如 /v1/text-to-video/{model}），行为一致。
视频类端点（文生 / 图生 / Omni / 动作控制）统一走批量 GET /tasks 查询（task_ids 与 external_task_ids 支持逗号批量）。数字人与声音复刻各有专属查询端点——数字人走 GET /videos/avatar/image2video/{task_id}、声音复刻走 GET /general/custom-voices/{task_id}，二者成功态为 succeed（区别于视频端点的 succeeded），不走 GET /tasks。Omni 的参考主体通过 contents 里的 refer_image 自动创建。文本转语音（TTS，POST /audio/tts）在本渠道不支持，调用返回 501，请改用「声音复刻 + 数字人」组合（详见下方常见问题）。主体管理（创建 / 查询 / 官方预置列表）已开放，用参考图 / 参考视频定义可复用主体并产出 element_id 供 Omni / 动作控制引用（渠道级能力、不计费，详见自定义主体）。暂未开放：主体的更新 / 删除、独立的音色管理 CRUD、单任务 GET /tasks/{id} 与游标分页 POST /tasks、回调（callback_url）投递。

​
模型定价

不同能力有两种计费口径：5 个视频模型按分辨率 × 时长（秒）计费，声音复刻按次计费。
1

提交预扣

视频任务创建成功后按参数（分辨率、时长）预扣额度；动作控制 / 数字人在输出时长未知时按最大计费时长（30 秒 / 300 秒）预扣，因此提交时需保证余额充足。声音复刻在提交时一次性按次扣费。
2

完成结算

视频任务成功后按实际时长结算，多退少补；任务失败全额退回。声音复刻无二次结算。
各分辨率每秒单价、动作控制 / 数字人的 mode（std→720p、pro→1080p）对应档位，以及声音复刻的按次单价，均以控制台「模型广场」与「日志中心」展示为准。实际扣费还会应用 API Key 所在分组的计费倍率。

​
限流与重试

  • 收到 429 或 5xx 时，建议指数退避重试（2s → 4s → 8s）。
  • 轮询查询接口建议间隔约 10 秒；4k 与长时长任务生成耗时更久，请适当延长轮询周期。

​
常见问题

不一样。可灵 3.0 是路径式接口（/text-to-video/{model} 等，路径可选加 /v1 前缀，带与不带一致），请求体用 settings / options / contents，提交与查询响应用 data.outputs[]、状态枚举 submitted / processing / succeeded / failed。旧版 /kling/v1 是 body 式接口，二者独立。
这是异步任务：提交返回任务 id，需轮询 GET /tasks?task_ids={id} 直到 status 为 succeeded，再从 outputs[].url 下载成片。
720p / 1080p / 4k（Turbo 通常至 1080p）。在请求 settings.resolution 中设置，具体可用档位以控制台「模型广场」为准。
纯文 / 图生视频且追求速度 → kling-3.0-turbo；需要 4k、多镜头、原生音频 → kling-3.0；需要参考图 + 参考视频 + 主体融合的多模态生成 → kling-3.0-omni（走 /omni-video）。
支持，三者都是专用端点：动作控制走 POST /motion-control/{model}（kling-3.0-motion-control，参考视频驱动图片 / 主体做动作，支持官方 contents / settings 或扁平结构 /videos/motion-control 两种形态），数字人走 POST /videos/avatar/image2video（kling-3.0-avatar，音频驱动人像口型），声音复刻走 POST /general/custom-voices（kling-3.0-voice，克隆音源音色）。查询上，动作控制属视频任务走 GET /tasks；数字人走专属 GET /videos/avatar/image2video/{task_id}、声音复刻走 GET /general/custom-voices/{task_id}，两者成功态为 succeed。声音复刻产出的 voice_id 可作为数字人的 audio_id 复用。此外自定义主体（主体管理）已开放——用参考图 / 参考视频创建可复用主体、查询拿到 element_id，再在 Omni / 动作控制里以 element 引用（渠道级能力、不计费）。仍暂未开放的是：主体的更新 / 删除、音色管理 CRUD 与回调（callback_url）。
统一使用批量 GET /tasks，task_ids 与 external_task_ids 均支持逗号批量查询（一次只认一种，task_ids 优先）。游标分页 POST /tasks 暂未开放。
不支持。可灵官方的文本转语音端点 POST /audio/tts（含 /v1 别名）在本渠道不可用，调用会返回 501 Not Implemented。如需「用指定音色说话」，请走两步替代方案：先用声音复刻 POST /general/custom-voices 克隆音色拿到 voice_id，再用数字人 POST /videos/avatar/image2video 以该 voice_id（作 audio_id）驱动人像开口说话。

​
相关文档

视频生成 API

参数、示例、三类生成端点与任务查询

快速开始

三步跑通第一个任务