模型服务 API 文档

kling-v3-omni

能多模态音视频生成模型，支持生图、视觉理解、视频生成，是 3.0 系列顶配版本Kling AI。原生支持多镜头分镜叙事、原生音频生成、音画同步，可同时使用文本、图片、视频作为参考输入，能锁定人物 / 物体形象一致性，最高输出 4K 分辨率视频，时长最长 15 秒；适合需要连贯多镜头、带人物配音、复杂故事脚本的专业创作场景。（注意：此模型我司暂时只支持生图）

已发布生图视觉

服务摘要

模型 IDkling-v3-omni

模型类型生图

计费方式按张计费

认证

所有请求均须携带用户控制台“Token 令牌管理”中创建的 API Key。API Key 的模型范围、有效期、IP 网段和额度限制由创建时的 Token 配置决定。

请求头

Authorization: Bearer <API Key>

获取 API Key

前往用户控制台创建 Token，并在模型授权范围中包含当前模型。

安全提示不要在浏览器前端代码、公开仓库或截图中暴露 API Key。API Key 泄露后请立即在用户控制台停用。

统一 API 地址

推荐直接使用统一入口。网关会读取请求中的 model，并按当前发布模型类型自动路由到对话、图片、视频、向量、重排序或音频等内部标准接口。

POST

https://model.wlaicloud.com/v1/

统一入口调用示例

以下示例使用当前模型的真实发布名称。请将 <API Key> 替换为您在用户控制台创建的 Key。

curl 示例

curl 'https://model.wlaicloud.com/v1/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{"model":"kling-v3-omni","prompt":"一座未来城市的日出景象","size":"1024x1024"}'

请求示例

{
  "model": "kling-v3-omni",
  "prompt": "一座未来城市的日出景象",
  "size": "1024x1024"
}

标准兼容接口

统一入口适用于大多数接入场景。若现有服务或 SDK 依赖标准接口，也可以使用以下路径；仅应调用与当前模型类型匹配的接口。

POST

https://model.wlaicloud.com/v1/images/generations

请求参数

参数	类型	说明
`model`必填	string	当前页面展示的模型 ID。
`prompt`必填	string	用于生成图片的提示词。
`size`	string	图片尺寸；具体支持范围以模型实际能力为准。

常见错误

状态码	原因	处理建议
`401`	未提供、无效或已停用 API Key	检查 Authorization 请求头，或在用户控制台重新创建 Token。
`403`	Token 未授权当前模型、IP 不在允许网段或账号不可用	检查 Token 的模型范围、IP 限制和状态。
`400`	模型类型与调用接口不匹配或参数不符合要求	确认请求体包含正确的 model；推荐改用统一入口 /v1/。
`429`	超过并发、速率或额度限制	降低并发并重试，或在用户控制台调整 Token 配额。
`5xx`	网关或上游模型服务暂时不可用	保留响应中的 request id，稍后采用退避策略重试。