用 Moonshot API 呼叫 Kimi K2.6：endpoint 與 model ID 別搞混

比較安全的接入流程

1. 準備 Moonshot API key。 Kimi 的 API 範例使用 Authorization: Bearer ... 驗證；TypingMind 的整合文件也描述了建立 Moonshot API 帳戶、儲值餘額與取得 API key 的流程。
2. 把 client 設成 OpenAI-compatible。 如果用 OpenAI SDK，重點是把 base_url 改成 https://api.moonshot.ai/v1。
3. 先呼叫 /models，再送正式請求。 List Models endpoint 用來列出目前可用模型，回應中的 id 才是應該傳給 model 參數的值。
4. 用 model 加 messages 發送 chat request。 Chat API 文件顯示請求結構包含 model 與 messages，API overview 則標出 /chat/completions 路徑。
5. 必要時查餘額或改用 batch。 Kimi 提供 balance endpoint 可查帳戶餘額，也提供 batch endpoint 來建立批次作業。

Python 範例：使用 OpenAI SDK

下面這段使用 Kimi 文件公布給 OpenAI SDK 的 base_url。 其中 KIMI_MODEL_ID 應該填入 GET /models 回傳的 id，不要從產品名稱或其他 gateway 的頁面自行複製。

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

第一步建議先列出你帳戶裡可用的模型，因為這個 endpoint 會回傳模型清單與 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 的 balance endpoint；官方範例使用 Bearer token。

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

不要混用 Moonshot 與第三方 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 時使用。若你打的是官方 Moonshot endpoint：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 發送請求。這樣做符合 Kimi 的 OpenAI-compatible 文件，也能避免把 AIMLAPI 或 OpenRouter 的 model ID 誤貼到官方 Moonshot API。