Kimi K2.6 APIの使い方：Moonshotで迷わないエンドポイントとmodel ID

Kimi K2.6を安全に呼び出す手順

1. MoonshotのAPI keyを用意する。 KimiのAPI例は

   Authorization: Bearer ...

   形式の認証を使っており、TypingMindの連携ドキュメントもMoonshot APIアカウント作成、残高追加、API key取得の流れを説明しています。
2. OpenAI互換クライアントとして設定する。 OpenAI SDKを使う場合、切り替えるべきポイントはbase_urlをhttps://api.moonshot.ai/v1にすることです。
3. 本番リクエストの前に/modelsを呼ぶ。 List Modelsエンドポイントはモデル一覧を返し、サンプル応答にもidフィールドがあります。この値をmodelパラメータに渡します。
4. modelとmessagesでチャットリクエストを送る。 Chat APIはmodelとmessagesを含む形式を示しており、API Overviewでは/chat/completionsのフルパスが示されています。
5. 必要に応じて残高確認やBatchを使う。 Kimiには残高確認用の/users/me/balanceと、Batch作成用の/batchesがあります。

Python例：OpenAI SDKで呼ぶ

次の例は、Kimiが案内しているOpenAI SDK向けのbase_urlを使います。 KIMI_MODEL_IDには、名前から推測したIDではなく、

GET /models

cURL例：model IDを確認してからChat Completionsへ送る

まずは、自分のMoonshot/Kimiアカウントで利用できるモデルを一覧します。このエンドポイントはモデル一覧とidを返します。

レスポンスから正しいidを選んだら、Chat Completionsに送ります。/chat/completionsのフルパスと、model＋messagesのリクエスト形式はいずれもKimiのドキュメントで示されています。

残高を確認する

課金や残高が原因と思われるエラーを切り分けたいとき、または組み込み前にアカウント状態を見たいときは、/users/me/balanceを使えます。KimiのCheck BalanceドキュメントではBearer tokenを使う例が示されています。

ゲートウェイごとのmodel IDを混ぜない

Kimi K2.6は、公式のMoonshot API以外にサードパーティのゲートウェイ経由で案内されている場合があります。たとえばAIMLAPIはhttps://api.aimlapi.com/v1/chat/completionsというエンドポイントで、modelにmoonshot/kimi-k2-6を使う例を示しています。 OpenRouterのAPIページではmoonshotai/kimi-k2.6というモデル名が表示されています。

これらは、それぞれのゲートウェイを通すときのIDです。Moonshot公式のhttps://api.moonshot.ai/v1/chat/completionsを呼ぶ場合は、AIMLAPIやOpenRouterのIDを流用せず、

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

まとめ

最短の実装フローは、MoonshotのAPI keyを用意し、OpenAI SDKのbase_urlをhttps://api.moonshot.ai/v1に設定し、/modelsでKimi K2.6の実際のmodel IDを確認してから、/chat/completionsへmodelとmessagesを送る、という流れです。これでKimiのOpenAI互換APIの仕様に沿いつつ、AIMLAPIやOpenRouterなど別ゲートウェイのmodel IDをMoonshot公式エンドポイントに誤って入れるミスを避けられます。