Kling: Kling 4.0 Omni Video API
可灵 4.0 全能参考生视频。一个接口组合参考图、参考视频、待编辑视频、主体与音色，可生成或编辑视频，最长 30 秒。
- 输入模态: text, image, video
- 输出模态: video
- 文件输入: 支持
- 发布日期: 2026-10-28
常见问题
为什么余额够一条视频的钱，提交时却提示余额不足？
提交时网关先按这次请求**最多可能扣的积分**预扣：没传 `settings.duration` 时模型可能按提示词出最长 30 秒的视频，所以按 30 秒估；带参考视频时输入视频也按上限估。任务完成后按可灵实际扣的积分结算，多扣的部分自动退回。传上 `settings.duration`，预扣就和实际费用基本一致。
生成结果的链接可以长期保存吗？
可灵生成的视频链接会在 **30 天后被清理**。站点开启了对象存储转存时，网关会在任务成功时自动把结果转存到自有存储（回调和统一任务接口给的是转存后的地址）；未开启时请及时下载保存。
任务要多久才能完成？如何拿到结果？
视频生成是异步任务，通常数十秒到数分钟，30 秒的长视频会更久。推荐在 `options.callback_url` 填回调地址，任务状态变化时网关主动推送；也可以轮询查询接口。
Kling 4.0 和 Kling 3.0 系列怎么选？
需要超过 15 秒的视频（4.0 最长 30 秒）、中间帧（多关键帧），或在一个请求里组合参考图、参考视频、主体、音色时选 4.0；需要 4K，或想要更低的每秒单价时选 3.0 系列（例如 3.0 无声 720P 每秒 0.6 积分）。
自建的主体和音色怎么用？
先用「主体管理」（`POST /kling/v1/general/advanced-custom-elements`）或「音色管理」（`POST /kling/v1/general/custom-voices`）创建，拿到 `element_id` / `voice_id` 后在 `contents` 里引用，并给它一个 `id`（如 `element_1`）在提示词里写 `@element_1`。用本站接口创建的主体和音色，网关会自动把请求发到创建它们的账号上。同一个请求里的自建主体和音色如果分别属于不同的服务节点，会返回 400，换用同一批创建的即可（例如创建主体时用 `element_voice_id` 绑定音色）。别人在本站创建的主体和音色不能引用。