Kimi K3.1 Proの使い方

Kimi K3.1 Pro を使う方法は 4 つあります。Kimi の Web またはモバイルアプリでチャットする、https://api.moonshot.ai/v1 の OpenAI 互換 API を通じて kimi-k3.1-pro を呼び出す、有料メンバーシップで Kimi Code CLI 内で実行する、あるいは Codex、Claude Code、OpenCode を Moonshot のエンドポイントに向ける、です。API は $1 のチャージ後に利用可能になり、入力トークン 100 万あたり $2、出力トークン 100 万あたり $10 のコストがかかります。

Moonshot AI は 2026 年 10 月 23 日に Kimi K3.1 Pro をリリースしました。これは Kimi K3 をポストトレーニングしたバージョンで、同じ 2.8T パラメータの MoE 設計（アクティブは約 104B）、1,048,576 トークンのコンテキストウィンドウ、そして常時オンの思考機能を備えています。まず背景を知りたい方はKimi K3.1 Pro とは何かをお読みください。一切費用をかけたくない場合は、Kimi K3.1 Pro を無料で使うガイドで $0 の方法をまとめています。以下の事実はすべて、2026 年 10 月 24 日に確認した Moonshot の発表、API クイックスタート、料金ページに基づいています。

どの Kimi K3.1 Pro のルートを選ぶべきか？

何を作っているかで選びましょう。チャットはちょっとした質問に、API はアプリに、Kimi Code はキーを管理したくないエージェントを求めるメンバーに、そして自分のエージェントはすでに Codex や Claude Code で作業しているチームに適しています。

Kimi の Web アプリとモバイルアプリで Kimi K3.1 Pro を使う

チャットアプリが最も手っ取り早い入り口です。Kimi の Web アプリ、または iOS、Android、HarmonyOS のアプリを開き、無料アカウントでサインインすると、コンポーザーでは K3.1 Pro がすでにデフォルトモデルになっており、思考の強度は High に設定されています。

サインイン前は、コンポーザーに K2.8 Preview と Instant も表示されます。プロンプトを送信するにはアカウントが必要です。Moonshot は無料プランの K3.1 Pro メッセージ上限を公開していないため [VERIFY]、チャットはテストの場として扱い、本番チャネルとは考えないようにしましょう。

Kimi Work デスクトップ 3.1.0 以降（Windows および Apple シリコン搭載 Mac）でもこのモデルを実行できます。Kimi Business と Enterprise では、起動時はデフォルトでオフになっているため、管理者が有効にする必要があります。

Kimi K3.1 Pro API：Python と cURL での最初の呼び出し

Kimi K3.1 Pro API は OpenAI 互換なので、標準の openai SDK がベース URL を変更するだけで使えます。セットアップは 3 ステップです：

1. 最低 $1 をチャージします。K3.1 Pro はフラッグシップモデルであり、チャージが成功した後にのみ利用可能になります。
2. API キーコンソールでキーを作成し、MOONSHOT_API_KEY としてエクスポートします。
3. https://api.moonshot.ai/v1 でモデル kimi-k3.1-pro（または kimi-k3.1-pro-highspeed）を呼び出します。

以下は Moonshot の公式 Python サンプルです：

import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["MOONSHOT_API_KEY"], base_url="https://api.moonshot.ai/v1")
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}],
)
print(completion.choices[0].message.content)

同じ呼び出しを cURL で書くとこうなります：

curl https://api.moonshot.ai/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model": "kimi-k3.1-pro","reasoning_effort": "high","messages": [{"role": "user", "content": "Introduce Kimi K3.1 Pro in one sentence."}]}'

このモデルはテキスト、画像、動画を入力として受け取り（クイックスタートでは image_url と video_url のパートが示されています）、テキストを返します。コードを書く前に Playground でプロンプトを試すこともできます。今も当てはまる K3 時代のパターンについては、Kimi K3 API ガイドをご覧ください。

Kimi K3.1 Pro の reasoning effort：low、high、max

reasoning_effort は、モデルが回答する前にどれだけ考えるかを設定するトップレベルのリクエストフィールドです。"low"、"high"、"max" を受け付け、デフォルトは "max" です。思考をオフにすることはできません。"medium" レベルはありません。

Moonshot のreasoning effort ガイドに完全なリファレンスがあります。出力トークンは 100 万あたり $10 を支払うため、単純な呼び出しで max から low に下げるのが最も簡単な節約方法です。temperature と top_p は省略してください。クイックスタートでは、これらは 1.0 と 0.95 に固定されていると記載されています。

推論をストリーミングし、マルチターンの状態を保ち、JSON を受け取る

API の挙動のうち、つまずきやすいポイントが 3 つあり、それぞれに簡単なルールがあります。

ストリーミング。 ストリーミング応答では、reasoning_content と content のデルタが別々に送られます。前者は表示またはログに残し、後者をレンダリングします：

stream = client.chat.completions.create(
    model="kimi-k3.1-pro", reasoning_effort="low", stream=True,
    messages=[{"role": "user", "content": "Explain MoE routing briefly."}],
)
for chunk in stream:
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="")
    if delta.content:
        print(delta.content, end="")

マルチターンとツール呼び出し。 アシスタントメッセージの content だけでなく、完全なメッセージを返送してください。Moonshot のドキュメントはこの点を明示しており、特にツール呼び出しが関わる場合に重要です：

messages.append(completion.choices[0].message)  # whole message, not .content
messages.append({"role": "user", "content": "Now add tests."})

モデルにツールを呼び出させる必要がある場合は tool_choice: "required" がサポートされています。部分モードも機能します。メッセージの最後を "partial": true を持つアシスタントメッセージで終えると、モデルがそれを続けます。

構造化出力。 タイプ json_schema と strict: true を指定した response_format を渡し、message.content のみをパースしてください。推論テキストを決してパースしないでください。

Kimi Code K3.1 Pro：メンバーシップ経由のルート

Kimi Code は Moonshot 自身のターミナルコーディングエージェントで、API キーが不要なルートです。代わりに Kimi アカウントでサインインします。これはメンバーシップ特典なので、無料の Adagio プランには含まれていません。

インストールしてサインインします：

# macOS / Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# Windows PowerShell: irm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi

セッション内で /login を実行し、次に /model で K3.1 Pro を選択します。2 つの ID はプラン阶层に対応しています：

• k3.1-pro：Moderato（Plus）以上。Allegretto（Pro）以上は最大 1M コンテキストを利用できます。
• k3.1-pro-highspeed：Allegretto（Pro）以上で、約 2 倍のクォータを使用します。

メンバーシップ料金では、Plus は年払いで月額 $15（月払い $19）、Pro は年払いで $31（月払い $39）です。Kimi Code ドキュメントにコマンドがまとめられており、Kimi Code CLI のウォークスルーでは日常的な使い方をより深く解説しています。

Codex で Kimi K3.1 Pro を使う

Codex は Responses API を通じて Kimi と通信し、Moonshot は公式の Codex ガイドを公開しています。~/.codex/config.toml に以下を追加します：

model = "kimi-k3.1-pro"
model_provider = "kimi"
model_context_window = 1048576

[model_providers.kimi]
name = "Kimi"
base_url = "https://api.moonshot.ai/v1"
env_key = "KIMI_API_KEY"
wire_api = "responses"

環境変数の名前に注意してください。Codex が読み取るのは KIMI_API_KEY であり、MOONSHOT_API_KEY ではありません。Moonshot のキーをその名前でエクスポートし、いつもどおり codex を起動します。

Claude Code で Kimi K3.1 Pro を使う

Moonshot は https://api.moonshot.ai/anthropic で Anthropic 互換の Messages エンドポイントを運用しているため、Claude Code はプロキシなしで動作します。~/.claude/settings.json の env ブロックに変数を記述します：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k3[1m]"
  }
}

このエイリアスは意図的なものです。Moonshot のトラブルシューティングページによると、直接の API 呼び出しと Codex は kimi-k3.1-pro を使い、Claude Code は互換エイリアス kimi-k3[1m] を使います。Claude Code ガイドでは他のモデル変数も設定しているので、それらはそちらからコピーしてください。

1 つ注意点があります。設定ファイルの env ブロック内の古い値は、シェルのエクスポートを上書きします。Claude Code が古いモデルを呼び続ける場合は、まずこのファイルを確認してください。

OpenCode

OpenCode は設定ファイルが不要です。opencode auth login を実行し、「Moonshot AI」を選択してキーを貼り付け、Moonshot AI のモデル一覧から K3.1 Pro を選びます。Moonshot の OpenCode ガイドは K3 向けに書かれているので、モデルが一覧に表示されることを確認してください [VERIFY]。

Apidog CLI でエージェントに Kimi API をテストさせる

Codex や Claude Code が K3.1 Pro で動くようになったら、その同じセッションを使って Kimi API 自体のリグレッションテストを進めましょう。エージェントがチェックを書いて実行し、あなたはプロンプトを 1 つ書くだけです。Apidog CLI は構造化された JSON 出力とスキーマを提供するので、ペイロードの形を推測することがありません。

CLI をインストールし、ログインして、エージェントスキルを追加します：

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
apidog skill install

次にエージェントにプロンプトを 1 つ与えます：

In Apidog project <projectId>, create an environment for https://api.moonshot.ai/v1.
Then create a test case for POST /chat/completions with model kimi-k3.1-pro and
reasoning_effort "low" that asserts status 200 and non-empty choices[0].message.content.
Run it and summarize any failures.

エージェントは環境を作成し、スキーマを読み、ペイロードを検証し、テストケースを書いて実行します：

apidog environment create kimi-prod --project <projectId> --base-url https://api.moonshot.ai/v1
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

テストケースには有効なカテゴリが必要で、apidog test-case category --project <projectId> で一覧を表示できます。空でない回答を伴う 200 は、API が reasoning_effort を受け入れた証拠にもなります。-r junit に差し替えれば、同じ実行がそのまま CI に組み込めます。Apidog CLI CI/CD ガイドで示しているとおりです。エージェント固有のセットアップはCodex での Apidog CLIとClaude Code での Apidog CLIにあります。Apidog の Free プランは最大 4 ユーザーまでカバーします。

Kimi K3.1 Pro のコストに関する注意点

API は従量課金で、サブスクリプションはなく、価格は税抜きです。

K3.1 Pro は入力と出力の両方で K3 より 3 割安いです。繰り返し現れるプレフィックスに対してキャッシュは自動で、デフォルトの TTL は 5 分で、キャッシュヒットは $0.20 で課金されます。Highspeed は 2〜3 倍高速で、価格は 2 倍です。

最低 $1 のチャージで、約 50 万入力トークンまたは 10 万出力トークンを購入できます。累計チャージが $5 に達すると $5 のバウチャーがもらえますが、バウチャーは累計チャージ額にはカウントされず、K3.1 Pro に適用されるかどうかは明記されていません [VERIFY]。$1 のアカウントは制限ページの Tier0 から始まり、同時リクエスト 1、RPM 3、1 日あたり 150 万トークンです。累計 $10 の Tier1 では RPM 100 に引き上げられます。

FAQ

Kimi K3.1 Pro はオープンウェイトですか？

まだいいえ。Moonshot は完全なモデルウェイトを 2026 年 11 月 4 日までに公開すると述べています。ライセンスは明示されていません。

K3.1 Pro と K3.1 Pro Highspeed の違いは何ですか？

同じモデルファミリーで、速度と価格が異なります。Highspeed は 2〜3 倍高速で、100 万トークンあたり $2/$10 に対して $4/$20 のコストがかかります。Kimi Code では Pro プランが必要で、約 2 倍のクォータを使用します。

Kimi K3.1 Pro で思考をオフにできますか？

いいえ。思考は常にオンです。推論トークンとレイテンシを削減するには、reasoning_effort を "low" に設定してください。

マルチターンの会話が壊れるのはなぜですか？

おそらくアシスタントの content だけを返送しています。Moonshot のドキュメントがマルチターンチャットとツール呼び出しに要求しているとおり、完全なアシスタントメッセージオブジェクトを履歴に追加してください。

Kimi API は無料ですか？

いいえ。K3.1 Pro は最低 $1 のチャージ後に利用可能になります。Kimi アプリでの無料チャットが $0 の選択肢で、無料ガイドで解説しています。

Kimi K3.1 Pro は 1M コンテキストウィンドウをサポートしますか？

はい。API は 1,048,576 トークンをサポートしています。Kimi Code では、完全な 1M コンテキストには Allegretto（Pro）以上が必要です。