Skip to Content

Kimi シリーズ

Moonshot AI(月之暗面)の Kimi モデルで、Kimi K3、K2.6、プログラミング向けの K2.7 Code があります。OpenAI 互換エンドポイントで呼び出せるほか、Anthropic ネイティブエンドポイントにも対応しており、Claude Code で使えます。

目的別ガイド

モデル

モデルの全一覧とリアルタイムの価格はモデルページ を参照してください。モデル ID のプレフィックスは moonshotai/ で、省略できます。

よく使うモデル ID(そのままコピーしてください)
Kimi K3moonshotai/kimi-k31M コンテキスト、画像入力に対応
Kimi K2.6moonshotai/kimi-k2.6256K コンテキスト、画像入力に対応
Kimi K2.7 Codemoonshotai/kimi-k2.7-codeプログラミング向け

Kimi モデルは Moonshot AI 公式(moonshot)が提供しており、一部のモデルは Azure AI Foundry、Alibaba Cloud Model Studio などのプロバイダーもあります。デフォルトでは自動で選択されます。指定方法はプロバイダールーティングを参照してください。

呼び出し例

kimi_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="moonshotai/kimi-k3", messages=[{"role": "user", "content": "冪等性とは何かを一文で説明してください。"}], extra_body={"thinking": {"type": "disabled"}}, ) print(resp.choices[0].message.content)

思考モード

ポイントKimi は思考がデフォルトで有効です。思考が不要な場合は、thinking の type を disabled に設定してください(K2.7 Code HighSpeed を除く)。
モデルデフォルト思考を無効にする
Kimi K3、K2.6、K2.7 Code有効"thinking": {"type": "disabled"}
Kimi K2.7 Code HighSpeed有効非対応。disabled を渡すと 400 を返す

同じ数学の問題で実測したところ、Kimi K3 はデフォルトで約 30 秒、思考を無効にすると約 3 秒でした。K2.6 はデフォルトで約 1.1 万トークンを思考して約 4.5 分かかり、思考を無効にすると約 40 秒でした。思考トークンは出力単価で課金され、数は usage.completion_tokens_details.reasoning_tokens で確認できます。

思考内容の読み取り:ストリーミングレスポンスでは delta.reasoning_content に、非ストリーミングレスポンスでは message.reasoning_details に含まれます。後者は各項目の text を順につなげてください。

Responses エンドポイントの tools に web_search を追加すると、モデルが自ら検索し、回答に引用元を付けます。

kimi_web_search.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.responses.create( model="moonshotai/kimi-k3", tools=[{"type": "web_search"}], input="Python の最新の安定版はいくつですか?", ) print(resp.output_text) for item in resp.output: if item.type == "message": for part in item.content: for a in getattr(part, "annotations", None) or []: print("引用元:", a.title, a.url)
  • 実測では Kimi K3 と K2.6 が対応しています。output には reasoning、web_search_call、message の項目が順に現れ、引用元は message コンテンツの annotations に含まれます。
  • 検索は回数単位で課金されます。単価はモデルページ を参照してください。

Claude Code で使う

Kimi モデルは Anthropic ネイティブエンドポイントに対応しており、アドレスは https://api.ofox.ai/anthropic です。

Claude Code の設定値
ANTHROPIC_BASE_URLhttps://api.ofox.ai/anthropic
ANTHROPIC_AUTH_TOKENOfoxAI の API Key を貼り付けてください
ANTHROPIC_MODELmoonshotai/kimi-k2.7-code

Anthropic エンドポイントで呼び出した場合、思考内容は thinking ブロックとして返されます。Claude Code の設定手順の詳細は Claude Code の設定を参照してください。

画像入力と構造化出力

  • Kimi K3、K2.6 は画像入力に対応しています。標準の image_url コンテンツブロックを使います。書き方は画像認識を参照してください。
  • response_format は json_schema と json_object に対応しています。ツール呼び出しには標準の tools パラメータを使います。書き方は構造化出力を参照してください。
  • 繰り返されるリクエストのプレフィックスは自動でキャッシュされ、ヒット量は usage.prompt_tokens_details.cached_tokens で確認できます。

よくあるエラー

HTTP · typeエラーメッセージ原文原因対処方法
400 invalid_request_errorinvalid thinking: only type=enabled is allowed for this modelK2.7 Code HighSpeed は思考の無効化に非対応thinking パラメータを削除するか、K2.7 Code に切り替える
429 rate_limit_errorRate limit reached for the requested model. Please retry after a short delay.リクエストの頻度が高すぎる時間をおいて再試行する。レート制限を参照
404 model_not_foundModel 'moonshotai/kimi-k9' not foundモデル ID のスペルミス、または moonshot/ プレフィックスを使ったプレフィックスは moonshotai/。このページからモデル ID をコピーする
リクエストのタイムアウト—思考がデフォルトで有効なため、複雑な問題では時間がかかる思考を無効にする、ストリーミング出力を使う、またはクライアントのタイムアウトを 600 秒以上に設定する

その他の一般的なエラーはエラー処理を参照してください。

公式ドキュメント

よくある質問

Kimi のモデル ID はどう書きますか?

標準の書き方は moonshotai/kimi-k3 で、プレフィックスを省略して kimi-k3 と書くこともできます。moonshot/kimi-k3 と書くと 404 が返ります。

Kimi の思考を無効にするには?

"thinking": {"type": "disabled"} を渡します。OpenAI SDK では extra_body に入れます。K2.7 Code HighSpeed は無効化に対応しておらず、渡すと 400 が返ります。

Kimi で Web 検索はできますか?

できます。Responses エンドポイントを使い、tools に {"type": "web_search"} を追加すると、回答に引用元が付きます。実測では Kimi K3 と K2.6 が対応しています。

Claude Code で Kimi を使えますか?

使えます。ANTHROPIC_BASE_URL を https://api.ofox.ai/anthropic に設定し、モデルに moonshotai/kimi-k2.7-code または moonshotai/kimi-k3 を指定します。

Kimi K2.6 が遅いのはなぜですか?

K2.6 は思考がデフォルトで有効なため、複雑な問題では 1 万トークン以上を思考して数分かかることがあります。思考が不要な場合は無効にするか、Kimi K3 に切り替えてください。

最終更新日