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で返った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 Completionsへ送る

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

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

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

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について短く紹介してください。"}]}'

残高を確認する

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

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

ゲートウェイごとの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側のidを使うのがもっとも確実です。

まとめ

最短の実装フローは、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公式エンドポイントに誤って入れるミスを避けられます。