Kimi K2.6 API 怎么用：Moonshot 端点、model ID 与快速示例

接入 Kimi K2.6 时，最容易出错的往往不是端点地址，而是 model 填错。Kimi 开放平台文档说明，它提供与 OpenAI 格式兼容的 HTTP API，可以直接使用 OpenAI SDK；用 SDK 时把 base_url 设为 https://api.moonshot.ai/v1，如果直接发 HTTP 请求，Chat Completions 的完整路径是 https://api.moonshot.ai/v1/chat/completions。

真正需要先核对的是模型 ID。List Models 页面提示 Kimi K2.6 已发布，但文档示例里的返回 id 仍以 kimi-k2.5 演示。因此，不要凭产品名猜 model，也不要直接复制第三方网关的写法；先在自己的 Moonshot 账号下调用

GET /models

先认准 Moonshot 端点

场景	配置或 endpoint	说明
使用 OpenAI SDK	base_url = https://api.moonshot.ai/v1	Kimi 文档说明 API 兼容 OpenAI，可直接使用 OpenAI SDK。
实时聊天补全	POST https://api.moonshot.ai/v1/chat/completions	API overview 给出完整路径；Chat API 文档展示了 model + messages 的请求结构。
列出可用模型	GET https://api.moonshot.ai/v1/models	返回模型列表，示例响应包含 id 字段；这个 id 才是应传给 model 的值。
检查账户余额	GET https://api.moonshot.ai/v1/users/me/balance	Check Balance 文档用 Authorization: Bearer ... 进行认证。
创建 batch	POST https://api.moonshot.ai/v1/batches	Batch API 文档给出创建 batch 的 endpoint。

推荐接入流程

1. 准备 Moonshot API key。 Kimi 的 API 示例使用

   Authorization: Bearer ...

   ；TypingMind 的 Kimi K2.6 集成文档也把流程写成创建 Moonshot API 账号、添加余额并获取 API key。
2. 把客户端指向 Moonshot。 如果使用 OpenAI SDK，关键不是换一套 SDK，而是把 base_url 改成 https://api.moonshot.ai/v1。
3. 先调用 /models。 List Models endpoint 用来列出当前可用模型，并在响应中提供 id；将这个值填入后续请求的 model 字段。
4. 再发送聊天请求。 Chat Completions 的请求按 model 和 messages 组织，HTTP 直连则发到 /chat/completions。
5. 按需查余额或跑批处理。 余额可用 /users/me/balance 检查，batch 任务可通过 /batches 创建。

Python 示例：OpenAI SDK

下面示例固定的是 Kimi 文档给出的 base_url；KIMI_MODEL_ID 应来自

GET /models

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['MOONSHOT_API_KEY'],
    base_url='https://api.moonshot.ai/v1',
)

response = client.chat.completions.create(
    model=os.environ['KIMI_MODEL_ID'],
    messages=[
        {'role': 'user', 'content': '你好，请用一句话介绍一下自己。'}
    ],
)

print(response)

cURL 示例：先拿 model ID，再发聊天请求

第一步建议先列出你自己账号可用的模型，因为 /models 的响应会给出可直接使用的 id。

curl -sS https://api.moonshot.ai/v1/models \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

选定响应里的 id 后，再调用 Chat Completions。Kimi 文档确认了 /chat/completions 的完整路径，以及 model、messages 这种请求结构。

curl -sS https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "PASTE_MODEL_ID_FROM_MODELS",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Kimi K2.6。"}
    ]
  }'

检查 API 余额

如果请求失败像是 billing 问题，或你想在接入前确认账户状态，可以调用 Kimi 的余额接口 /users/me/balance；文档示例同样使用 Bearer token。

curl -sS https://api.moonshot.ai/v1/users/me/balance \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

不要混用第三方网关的 model ID

有些中间服务会为 Kimi K2.6 使用自己的模型 ID 和入口。AIMLAPI 的示例 endpoint 是 https://api.aimlapi.com/v1/chat/completions，model 写作 moonshot/kimi-k2-6。 OpenRouter 的 Kimi K2.6 API 页面显示的模型名是 moonshotai/kimi-k2.6。

这些写法只应在调用对应平台时使用。回到 Moonshot 的 https://api.moonshot.ai/v1/chat/completions，更稳妥的做法始终是先请求

GET https://api.moonshot.ai/v1/models

一句话结论

最稳的接入顺序是：拿到 API key，设置 OpenAI SDK 的 base_url 为 https://api.moonshot.ai/v1，调用 /models 核准 Kimi K2.6 的模型 ID，然后向 /chat/completions 发送带 model 和 messages 的请求。这样既符合 Kimi 的 OpenAI-compatible 文档，也能避开把 AIMLAPI 或 OpenRouter 的 model ID 误填到 Moonshot 端点里的常见错误。