Kimi K2.6 API 點用：Moonshot endpoint、model ID 同快速調用範例

建議流程：不估、不抄，先驗證

1. 準備 Moonshot API key。 Kimi API 文件的例子使用 Authorization: Bearer ... 做認證；TypingMind 的整合文件亦描述了建立 Moonshot API 戶口、充值 balance、取得 API key 的流程。
2. 用 OpenAI-compatible 方式設定 client。 如果你用 OpenAI SDK，關鍵是把 base_url 改成 https://api.moonshot.ai/v1。
3. 正式送 request 前先打 /models。 List Models endpoint 會列出目前可用的 models，response 內的 id 就是你應該傳入 model 參數的值。
4. 用 model 同 messages 發 chat request。 Chat API 文件展示的 request 結構包含 model 與 messages，API overview 則列出 /chat/completions 這條 endpoint。
5. 需要時先查餘額或用 batch。 Kimi 提供 balance endpoint 查戶口狀態，也有 batch endpoint 建立批次工作。

Python：用 OpenAI SDK 調用

以下例子只把 Kimi 官方列明的 base_url 寫死；KIMI_MODEL_ID 必須來自你自己 GET /models 的回傳 id，不要用產品名自己估，也不要抄其他 gateway 的 model 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，再發 chat

第一步建議先列出你 Moonshot/Kimi 戶口入面可用的 models，因為這個 endpoint 會回傳 model 清單同 id 欄位。

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

選好 response 入面的正確 id 之後，才把它放進 Chat Completions request。Kimi 文件有列出 /chat/completions 的 full path，亦展示 model + messages 的 request 結構。

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 餘額

如果 request 因 billing/餘額問題出錯，或者你想整合前先確認戶口狀態，Kimi 有 /users/me/balance endpoint，文件例子使用 Bearer token。

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

不要把第三方 gateway 的 model ID 直接搬過來

部分中介服務會為 Kimi K2.6 設定自己的 model ID。AIMLAPI 的文件使用 https://api.aimlapi.com/v1/chat/completions，model 寫作 moonshot/kimi-k2-6。 OpenRouter 的 API 頁面則顯示 model 為 moonshotai/kimi-k2.6。

這些 ID 只應該在你經相應 gateway 調用時使用。當你打的是官方 https://api.moonshot.ai/v1/chat/completions，低風險做法仍然是先 GET https://api.moonshot.ai/v1/models，再用 Moonshot 對你戶口實際回傳的 id。

總結

最乾淨的接法是：取得 API key；把 OpenAI SDK 的 base_url 設成 https://api.moonshot.ai/v1；先打 /models 確認 Kimi K2.6 的可用 model ID；最後向 /chat/completions 送出包含 model 與 messages 的 request。這樣做同 Kimi 的 OpenAI-compatible 文件一致，亦可避開把 AIMLAPI 或 OpenRouter 的 model ID 複製到 Moonshot 官方 endpoint 這個常見錯誤。