Kimi K2 API 導入ガイド:料金・無料枠・Python 呼び出し(2026)
Moonshot の Kimi K2 API を実際に動かす手順。キー取得、curl と Python の呼び出し例、公式直結と集約経由の料金比較(入力 $0.55/M〜)、256K コンテキスト・レート制限・よくあるエラー、そして 1 つのキーで Kimi・GPT・Claude を呼ぶ方法まで。
Kimi K2 は Moonshot AI(月之暗面)のフラッグシップ MoE モデルです。長いコンテキストと手頃なコストパフォーマンスから、エージェント・コーディング・長文処理を作るチームにとって有力な選択肢になっています。本記事は「キーを取る → 最初のリクエスト → コストを把握 → レート制限を理解」の順に、Kimi K2 API を実際に動かすところまで案内します。急ぐ場合は、推奨コードで GetModel の無料枠を受け取り、1 つのキーで Kimi・GPT・Claude を呼べます。
Kimi K2 の概要
Kimi K2 は Mixture-of-Experts(MoE)アーキテクチャを採用し、総パラメータ約 1T・推論時のアクティブ約 32B で、「大規模モデルの能力を疎な活性化のコストで」を狙います。主力は次の 3 モデルで、API と使い方は共通、違いは能力ティアと価格です。
kimi-k2(初代 0711) — 最初に公開された版で価格が最も低く、コスト重視の汎用タスク向け。kimi-k2.5— 総合的にアップグレードされ、キャッシュヒット割引に対応。日常的な中程度のタスク向け。kimi-k2.6(最新) — 現時点で最も高性能なティア。コードやエージェント用途で最も優秀で、同じくキャッシュ割引に対応。
ほかに kimi-k2-thinking(強い推論)、kimi-k2-turbo(高速)、コーディング特化の kimi-k2.7-code などの派生もあります。Moonshot は更新が速いので、導入前にコンソールで現行の型番を確認してください。全モデルが 256K トークンのコンテキストウィンドウを備え、マニュアル 1 冊やコードベースの大きな塊を一度に処理できます。これが同価格帯の多くのモデルに対する主な強みです。
インターフェースは OpenAI の Chat Completions 形式に完全互換(一部チャネルは Anthropic 互換も提供)なので、既存の openai SDK コードは通常 2 か所を変えるだけで切り替えられます。
導入手順とコード
以下の 2 通りがあります。公式直結は Kimi 単体利用向け、集約経由は GPT・Claude・Gemini も併用し、複数のキーと請求を管理したくない場合に向いています。
方法 1:公式直結(Moonshot プラットフォーム)
- Moonshot オープンプラットフォーム に登録・ログイン(中国国内は
platform.moonshot.cn); - 「API キー管理」でキーを作成;
- ベース URL を確認:
https://api.moonshot.ai/v1(中国国内はhttps://api.moonshot.cn/v1)。
curl の例:
curl https://api.moonshot.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-d '{
"model": "kimi-k2.6",
"messages": [{"role": "user", "content": "Kimi K2 を一文で紹介して"}]
}'
Python(openai SDK をそのまま利用。base_url と model だけ変更):
from openai import OpenAI
client = OpenAI(
api_key="あなたの-Moonshot-Key",
base_url="https://api.moonshot.ai/v1",
)
resp = client.chat.completions.create(
model="kimi-k2.6",
messages=[{"role": "user", "content": "Kimi K2 を一文で紹介して"}],
)
print(resp.choices[0].message.content)
ストリーミングは stream=True を付けるだけ(SSE 形式は OpenAI と同一)。ツール呼び出しは OpenAI の tools フィールドで書け、追加のアダプタは不要です。
方法 2:集約経由(1 つのキーで Kimi / GPT / Claude)
Kimi だけでないプロジェクトなら、GetModel のような集約ゲートウェイが便利です。1 つのキー、1 つの OpenAI 互換エンドポイントで、model フィールドを変えるだけでモデルを切り替えられ、残高は全モデル共通、請求も 1 本にまとまります。
- GetModel コンソール にログインし、「API トークン」ページで
sk-で始まるキーを作成; - ベース URL を
https://getmodel.ai/v1に; modelにkimi-k2を指定。詳細な型番と能力は Kimi K2 モデルページを参照。
from openai import OpenAI
client = OpenAI(
api_key="sk-あなたのGetModelKey",
base_url="https://getmodel.ai/v1",
)
# Kimi K2 を呼ぶ
resp = client.chat.completions.create(
model="kimi-k2",
messages=[{"role": "user", "content": "こんにちは、Kimi"}],
)
print(resp.choices[0].message.content)
# 同じコードで model を gpt-5.2 や claude-sonnet-5 に変えれば別ベンダーに切替
ゲートウェイ側にマルチチャネルのフェイルオーバーが組み込まれており、上流が不安定なときは自動で切り替わるため、本番でも安定します。
料金比較:公式直結 vs 集約経由
Kimi K2 はトークン課金で、モデルごとに価格が異なり、K2.5 / K2.6 は「キャッシュヒット」割引に対応します。長い system prompt や固定文書などの繰り返しプレフィックスがキャッシュに当たると、入力単価は定価の 1〜2 割に下がります。以下は 100 万(1M)トークンあたりの参考価格(米ドル。公式サイト / コンソールの実時価格を優先):
| モデル | 入力 / 1M | 出力 / 1M | キャッシュ入力 / 1M |
|---|---|---|---|
kimi-k2(初代 0711) | $0.55 | $2.20 | — |
kimi-k2.5 | $0.60 | $3.00 | $0.10 |
kimi-k2.6(最新) | $0.95 | $4.00 | $0.16 |
注意点:
- 初代 K2 は単価が最も低い —— ピーク性能が不要な純粋な物量処理で最も割安;
- K2.6 は単価が最高だが、キャッシュ入力は $0.16 —— 長い prompt を繰り返し呼ぶ場面では実コストが見た目より大幅に低くなることも;
- 公式や各リセラー/集約の価格は変動するため、利用前に実時価格を確認してください。GetModel 上の Kimi と他モデルの実時単価は料金ページで確認できます。
無料枠:GetModel は提携パートナーやクリエイターの推奨コードで登録すると体験クレジットを受け取れ、これは全モデル共通なので、Kimi・GPT・Claude を横並びで試してからメインを決められます。Moonshot 公式自体の体験クレジットの扱いは、その公式サイトの記載に従ってください。
コンテキスト長とレート制限
コンテキスト:Kimi K2 全系が 256K トークンのコンテキストを提供し、長文 Q&A、リポジトリ全体のコード解析、長いマルチターン対話に向きます。ただしコンテキストが長いほど 1 回のリクエストのトークン消費と遅延が増えるため、長文用途ではキャッシュと併用し固定部分を再利用して節約しましょう。
レート制限:公式はアカウント等級で RPM(毎分リクエスト数)、TPM(毎分トークン数)、同時実行の上限を分けます。新規アカウントは低めで、チャージや利用量に応じて緩和されます。制限に達すると API は 429 を返すので、本番では必ず指数バックオフを入れてください。GetModel 経由ではキーとグループ単位で制限され(コンソールで確認可)、マルチチャネルのフェイルオーバーが重なるため、単一上流の制限は自動で迂回されます。
よくあるエラーと対処
- 401 / 認証失敗:キーの打ち間違い、
Bearerプレフィックス漏れ、別環境のキー使用など。Authorizationヘッダーと base_url が対応しているか確認。 - 429 / レート制限:RPM/TPM や同時実行の上限超過。指数バックオフ、同時実行数の削減、または等級の引き上げを。GetModel 経由ならマルチチャネルのフェイルオーバーが自動で迂回。
- コンテキスト超過:入力が 256K トークンを超えるとエラー。入力の削減・分割、または固定プレフィックスのキャッシュ再利用を。
- タイムアウト / 接続断:長い入力やネットワークの不安定が原因。適切な
timeoutを設定して再試行。本番ではゲートウェイ側の自動リトライとフェイルオーバーを有効に。
よくある質問(FAQ)
- Kimi K2 に無料枠はある? あります。公式は新規ユーザーに体験クレジットを付与。GetModel 経由の登録でも全モデル共通のクレジットが付き、試してから使うのに向きます。
- K2・K2.5・K2.6 どれを選ぶ? 物量重視なら
kimi-k2、日常のバランス用途ならkimi-k2.5、コード/エージェント/複雑推論ならkimi-k2.6(長い prompt でキャッシュ併用が最も割安)。 - ツール呼び出しとストリーミングは? どちらも対応。ツール呼び出しは OpenAI の
toolsフィールド、ストリーミングはstream=Trueで OpenAI と同一形式。 - 中国国内から直接呼べる? はい、公式が
api.moonshot.cnを提供。GPT や Claude など海外モデルも使うなら、集約ゲートウェイなら 1 つのキーで完結します。 - 既存の OpenAI コードは流用できる? できます。Kimi K2 は OpenAI Chat Completions 互換で、通常は
base_urlとmodelの 2 か所だけ変更します。
Kimi・GPT・Claude・Gemini を 1 つのコードベース・1 つのキー・1 本の請求で使うなら、GetModel コンソールから体験クレジットで Kimi K2 を動かしてみてください。