模型服务 API 文档

kling-image-o1

专业图像生成模型，主打生图 + 图像视觉理解能力Kling AI。核心四大优势：高特征保留（主体形象稳定不崩坏）、高精度细节修改、精准风格色调控制、丰富创意表现力；支持多张参考图融合特征，可基于文字 / 参考图产出高质量图片，适合商业插画、概念设计、实景可视化、图片精细化修图等图像创作场景。

已发布生图视觉

服务摘要

模型 IDkling-image-o1

模型类型生图

计费方式按张计费

认证

所有请求均须携带用户控制台“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-image-o1","prompt":"一座未来城市的日出景象","size":"1024x1024"}'

请求示例

{
  "model": "kling-image-o1",
  "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，稍后采用退避策略重试。