Kimi 系列

模型	上下文	最大输出
`kimi-k3`	262,144	16,000
`kimi-k2.6`	262,144	16,000
`kimi-k2.5`	262,144	16,000

公开协议

使用 OpenAI 兼容的 POST /v1/chat/completions。三个版本共享同一请求结构，支持多轮消息、流式输出和工具调用；kimi-k3 还支持在消息内容中传入图片进行视觉理解。模型名大小写必须与模型列表一致。

curl https://api.vibelab.me/v1/chat/completions \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "messages": [{"role": "user", "content": "总结这份周报的三个关键结论"}],
    "max_tokens": 4096
  }'

请求参数

参数	类型	必填	默认值	说明
`model`	string	是	-	本页适用模型之一，大小写敏感
`messages`	array	是	-	对话消息列表
`messages[].role`	string	是	-	`system`、`user`、`assistant` 或 `tool`
`messages[].content`	string/array	是	-	消息文本；`kimi-k3` 可使用 `text` 与 `image_url` 内容块
`stream`	boolean	否	`false`	是否启用 SSE 流式输出
`max_tokens`	integer	否	模型默认	最大输出 Token 数
`temperature`	number	否	`1`	采样温度
`top_p`	number	否	`1`	核采样阈值，范围 `(0, 1]`
`stop`	string/array	否	-	停止序列
`tools`	array	否	-	函数工具定义
`tool_choice`	string/object	否	`auto`	工具调用策略
`response_format`	object	否	`{"type":"text"}`	输出格式

Kimi K3 视觉理解

kimi-k3 的用户消息可以把 content 从字符串改为内容对象数组，在同一条消息中组合文本和图片。

`content[]` 字段	类型	必填	说明
`type`	string	是	文本固定为 `text`，图片固定为 `image_url`
`text`	string	`type=text` 时是	文本提示词
`image_url.url`	string	`type=image_url` 时是	公网图片 URL，或 `data:image/...;base64,...` Data URL
`image_url.detail`	string	否	图片理解精度，可选 `low`、`high` 或 `auto`

公网图片 URL 由 LoopToken 下载并转换为 Kimi K3 可接受的 Data URL。URL 必须使用 HTTPS、无需 Cookie 或登录即可访问，且 DNS 解析结果必须全部为公网地址；支持 JPEG、PNG、WebP 和 GIF。每个请求最多 4 张远程图片，单图最大 8 MiB、远程图片合计最大 16 MiB。下载失败、格式不支持或触发安全限制时，平台在扣费前返回 HTTP 400 invalid_image_url。

图片 URL

curl https://api.vibelab.me/v1/chat/completions \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "描述图片内容，并列出三个关键细节"},
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/photo.jpg",
            "detail": "high"
          }
        }
      ]
    }],
    "stream": false
  }'

Base64 图片使用相同结构，只需把 image_url.url 改为 Data URL：

{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }
}

响应参数

参数	类型	说明
`id`	string	请求 ID
`object`	string	对象类型
`created`	integer	Unix 时间戳
`model`	string	模型名称
`choices[].index`	integer	候选结果序号
`choices[].message.role`	string	`assistant`
`choices[].message.content`	string/null	生成文本
`choices[].message.tool_calls`	array	工具调用列表
`choices[].finish_reason`	string	停止原因
`usage.prompt_tokens`	integer	输入 Token 数
`usage.completion_tokens`	integer	输出 Token 数
`usage.total_tokens`	integer	总 Token 数

成功响应

{
  "id": "chatcmpl_01H...",
  "object": "chat.completion",
  "created": 1783819200,
  "model": "kimi-k3",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "关键结论：1. 转化率环比提升 12%；2. 渠道成本下降；3. 下周需完成灰度发布。"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 96, "completion_tokens": 42, "total_tokens": 138}
}

计费与错误

Kimi 系列按 Token 计费。kimi-k3 的普通输入、缓存命中输入和输出分别计价；上游响应提供缓存命中数量时，平台读取 usage.prompt_tokens_details.cached_tokens 并按缓存输入档位结算。当前单价以模型列表展示的实时价格为准。

错误响应格式及状态码见错误码。