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

如果你想由 Moonshot 官方 Kimi API 用 Kimi K2.6，先記住一件事：最易中伏的通常唔係 URL，而係 model 填錯。Kimi Open Platform 表示，它的 HTTP API 兼容 OpenAI，可以直接用 OpenAI SDK；用 SDK 時要把 base_url 設為 https://api.moonshot.ai/v1，如果直接打 HTTP，chat 的完整 endpoint 是 https://api.moonshot.ai/v1/chat/completions。

真正要小心的是 model ID。Kimi 的 List Models 頁面寫明 Kimi K2.6 已發布，但文件中的 sample response 仍然用 id = kimi-k2.5 做示例。最穩陣做法，是在你自己的 Moonshot 戶口先打

GET /models

Moonshot 官方 endpoint 速查

用途	設定或 endpoint	要點
用 OpenAI SDK	base_url = https://api.moonshot.ai/v1	Kimi 說明 API 是 OpenAI-compatible，可直接使用 OpenAI SDK。
即時 chat	POST https://api.moonshot.ai/v1/chat/completions	API overview 列出這個 full path；Chat API 文件使用 model + messages 的 request 形式。
列出可用 model	GET https://api.moonshot.ai/v1/models	Endpoint 會回傳 model 清單，sample response 內有 id 欄位。
查 API 餘額	GET https://api.moonshot.ai/v1/users/me/balance	Check Balance 文件用 Authorization: Bearer header。
建立 batch	POST https://api.moonshot.ai/v1/batches	Batch API 文件有建立 batch 的 endpoint。

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

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

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

總結

最乾淨的接法是：取得 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 這個常見錯誤。