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

推荐接入流程

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 返回的 id，不要手写猜测，也不要从别的网关复制。

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，再把 Moonshot 返回的 id 填入 model。

一句话结论

最稳的接入顺序是：拿到 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 端点里的常见错误。