Kimi K3

Kimi K3 は HopBase の OpenAI Chat Completions 互換プロトコルを使用します。https://api.hop-base.com/v1 を使い、モデル名は kimi-k3 を指定してください。

プラン選択と課金

• コンソールの API Keys で API キーを新規作成する際、キーのプランを「Kimi K3 専線」(Kimi K3 専用回線)に設定してください。このキーで kimi-k3 を呼び出せます。
• 料金は料金ページをご覧ください。実際の適用レートはログイン後のモデルカタログに表示されます。
• 1 つのキーは 1 つのプランに紐づきます。別のプランに紐づいたキーで kimi-k3 を呼び出すと明確な 404 が返ります。このプランで新しいキーを作成するか、コンソールで既存のキーのプランを付け替えてください。

クライアント設定項目

クライアントごとの対応状況

Kimi K3 は POST /v1/chat/completions のみを提供します。/v1/responses と /v1/messages はこのモデルに対して両方とも 404 を返すため、OpenAI Responses プロトコルまたは Anthropic Messages プロトコルしか話せないクライアントには、プロトコル変換レイヤーが必要です。

リクエストパラメータの制限

2026-09-09 に本番ゲートウェイでパラメータごとに実測した結果です。

CC Switch で Claude Code から Kimi K3 を利用する

CC Switch 3.17.0 以降(最新版の利用を推奨)を使用してください。Kimi K3 は OpenAI Chat Completions を使用するため、CC Switch のローカルルーターが Claude Code で使われる Anthropic Messages プロトコルへの変換を行う必要があります。

CC Switch で Codex CLI から Kimi K3 を利用する

こちらも CC Switch 3.17.0 以降が必要です。CC Switch は Codex がローカルルーター(デフォルト 127.0.0.1:15721)に対して Responses 形式で通信し続けるようにし、ルーターが各リクエストを HopBase 向けの Chat Completions に書き換え、レスポンスを Responses 形式に戻して返します。

思考出力、プレフィックスキャッシュ、ツール呼び出し

2026 年 9 月に HopBase が本番ゲートウェイで実測した結果です。

• Kimi K3 は現時点で思考の過程を返しません。 レスポンスに reasoning_content フィールドは含まれず、usage.completion_tokens_details.reasoning_tokens は常に 0 です。つまり出力トークンはすべて回答本文です。リクエストに thinking や reasoning_effort を含めてもエラーにはなりませんが、効果はありません。max_tokens は思考分を確保する必要がなく、回答本文の長さだけで設定してください(上限 32,768)。
• 長いコンテキストでも正常に動作し、正確に検索できます。 206,079 トークンの単一入力でも正常にレスポンスが返り、深さ 60% の位置に埋め込まれた情報が正確に取り出されました(非ストリーミングで初回バイトまで 78 秒)。
• プレフィックスキャッシュはプレフィックス全体にヒットします。 同じプレフィックスを繰り返すと、usage.prompt_tokens_details.cached_tokens が一致したプレフィックス長と等しくなります(2,093 トークンのシステムプロンプトなら、2 回目の呼び出しで 2,093 トークン全体がヒットします)。この分はキャッシュ料金で課金されます。システムプロンプトやツール定義などの固定コンテンツはメッセージリストの先頭に置いてください。
• ツール呼び出しは動作します。 tools、tool_choice(required を含む)、parallel_tool_calls、$ref と $defs を使った JSON Schema、複数ターンにわたる tool メッセージのいずれも、ストリーミング・非ストリーミングの両方で正常に動作します。
• ストリーミング時の usage。 最後のチャンクで usage を受け取るには、リクエストに "stream_options": {"include_usage": true} を含めてください。
• レイテンシの目安。 通常のチャットでは初回トークンまで約 4〜7 秒、長文出力ではおよそ 40 トークン/秒、ツール呼び出しでは初回トークンまで約 15〜20 秒です。4 並列のストリームでも失敗は見られませんでした。クライアント側ではリトライを維持し、読み取りタイムアウトは 300 秒以上を確保してください。

OpenAI SDK / Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.hop-base.com/v1",
    api_key="sk-your-key",
)

resp = client.chat.completions.create(
    model="kimi-k3",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Explain where Kimi K3 works best"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

curl

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Hello, introduce yourself"}]
  }'

FAQ

• /v1/responses または /v1/messages が 404 を返します。 このモデルには /v1/chat/completions しかありません。Codex CLI と Claude Code は上記の手順に沿って CC Switch 経由でルーティングしてください。HopBase のアドレスを ~/.codex/config.toml や ANTHROPIC_BASE_URL に直接入力しないでください。
• Codex が wire_api = "chat" is no longer supported というエラーで起動しません。 新しいバージョンの Codex は Chat Completions への直接接続をサポートしなくなりました。手書きの provider 設定を削除し、CC Switch に引き継がせてください。
• kimi-k3 を呼び出すと 404 model not found が返ります。 キーが「Kimi K3 専線」プランに属していません。新しいキーを作成するか、既存のキーを付け替えてください。
• Codex の /model メニューに kimi-k3 が表示されません。 モデルマッピングを保存した後、Codex を再起動するとメニューが更新されます。
• exceeds the limit of 32768 という 422 が返ります。 max_tokens が 32,768 を超えています。値を下げてください。
• 「リクエストパラメータを確認してください」としか書かれていない 400 が返ります。 まず top_p(いかなる値も受け付けません)、n が 1 より大きい設定、0 以外の frequency_penalty または presence_penalty を確認してください。
• 同時実行数の上限に達したという 429 が返ります。 これはアカウントの同時実行数制限(デフォルト 5)です。同時実行のベンチマークやマルチエージェントのワークロードを実行する前に、上限引き上げをご相談ください。