模型服务 API 文档

kimi-k3

Kimi K3 是一个 2.8 万亿参数模型，基于 KDA 混合线性注意力机制 (Kimi Delta Attention) 和注意力残差 (Attention Residuals) 技术构建，原生支持视觉理解，并拥有 100 万 token 上下文窗口。它是全球首个开源的 3 万亿级别模型，面向长程编程、知识工作和推理等前沿智能场景而设计。

已发布对话推理

服务摘要

模型 IDkimi-k3

模型类型对话

计费方式按量计费

认证

所有请求均须携带用户控制台“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":"kimi-k3","messages":[{"role":"user","content":"请介绍未来智能云。"}],"stream":true}'

请求示例

{
  "model": "kimi-k3",
  "messages": [
    {
      "role": "user",
      "content": "请介绍未来智能云。"
    }
  ],
  "stream": true
}

标准兼容接口

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

POST

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

请求参数

参数	类型	说明
`model`必填	string	当前页面展示的模型 ID。
`messages`必填	array	对话消息列表，每条消息包含 role 和 content。
`stream`	boolean	是否使用流式响应；默认 false。
`temperature`	number	可选采样温度；是否支持由具体模型决定。

常见错误

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