Model and Modality Playbooks2026年9月11日Flatkey Team

Kimi 3 API（Kimi K3）：開発者が知っておくべきこと

Kimi K3 APIのアクセス方法、料金、推論設定、マルチモーダルの制限、移行時の確認事項、Flatkeyによるルーティングについて、最新の情報源に基づいてまとめたガイドです。

Kimi 3 API を探している場合、コードで使用すべき公式のモデル名は Kimi K3 です。この違いは重要です。なぜなら、モデルのドキュメント、SDK の例、料金表、API のモデル識別子はいずれも kimi-k3 を使用しており、kimi-3 ではないからです。

2026年9月11日現在、Kimi 自身の Kimi K3 ガイドでは、Kimi K3 は長期的なコーディング、エンドツーエンドの知識作業、深い推論、画像理解、動画理解、そして 100万トークンのコンテキストワークフロー向けのフラッグシップモデルとして記載されています。Kimi API Platform は、OpenAI互換の Chat Completions、OpenAI互換の Responses、Anthropic互換の Messages プロトコルを通じてこれを提供しているため、開発者はすべてのリクエストラッパーを一から作り直すことなく Kimi K3 を評価できます。

このガイドでは、Kimi 3 API の検索クエリについて現在何が最新なのか、Kimi K3 を直接呼び出す方法、最初の K3 ローンチ報道から何が変わったのか、そしてインディーハッカーが直接のプロバイダールートまたは Flatkey のようなマルチモデルゲートウェイを通じて Kimi K3 をテストする方法を説明します。

Kimi 3 API と Kimi K3 API の違い

Kimi K3 が公式名称です。Kimi 3 API は便利な検索フレーズです。というのも、主要なモデル世代が発表されると、多くの開発者がバージョン風の表現を使うからです。

用語は次のように使ってください。

記事タイトルや教育用の文章では、「Kimi 3 API (Kimi K3)」とすることで、検索フレーズを公式モデルに結び付けやすくなります。
API リクエストでは、model フィールドに kimi-k3 を使用します。
エンジニアリングのチケットやドキュメントでは、最初の説明以降は「Kimi K3」を使うのが望ましいです。

これにより、単純ですが高くつくミスを避けられます。つまり、人気の検索フレーズをそのままコードにコピーしてしまい、アカウントアクセスとは無関係な model-not-found エラーをデバッグすることです。

現在の Kimi K3 API の事実

最新の Kimi API ドキュメントでは、Kimi K3 はネイティブの画像理解と 1,048,576 トークンのコンテキストウィンドウを備えた 2.8 兆パラメータのモデルとして説明されています。Kimi は完全なモデル重みが公開されたと述べており、これはローンチ週の「重みは 2026年7月27日までに公開予定」という表現に取って代わるものです。

項目	現在の開発者向けメモ
公式モデル名	Kimi K3
API モデル ID	`kimi-k3`
OpenAI互換の直接ベース URL	`https://api.moonshot.ai/v1`
Chat エンドポイント	`/chat/completions`
Responses エンドポイント	`/responses`
Anthropic互換のベース URL	`https://api.moonshot.ai/anthropic`
コンテキストウィンドウ	1,048,576 トークン
モダリティ	テキスト、画像、動画入力が文書化されています
推論	K3 では常に有効; `reasoning_effort` を使用
推論 effort の値	`low`, `high`, `max`; デフォルトは `max`
アクセス要件	最低 $1 の入金成功で API 利用が有効化されます
直接の Kimi 料金	キャッシュヒット入力 $0.30、キャッシュミス入力 $3.00、出力 $15.00 / 100万トークン、適用される税を除く

価格、ルートの可用性、レート制限は変更される可能性があるため、固定値は恒久的な契約ではなく、デプロイ前の確認項目として扱ってください。Kimi独自の価格とレート制限のドキュメントは、本番展開の予算を組む前に確認すべきです。

ローンチ週から何が変わったか？

以前のKimi K3の記事を読んだことがある場合は、その助言をそのまま流用する前に、次の点を再確認してください:

KimiのK3ドキュメントでは、フルモデルの重みがすでにリリースされたと記載されています。
Kimiのモデル一覧では、kimi-k3 がいくつかの廃止済みモデルIDの移行先として位置付けられています。
kimi-k2.5 と moonshot-v1 シリーズは2026年8月31日に廃止され、これらのモデルへの呼び出しは、Kimiのモデル一覧およびプラットフォームの変更履歴によると、現在は model-not-found エラーを返します。
API概要では、OpenAI Chat Completions、OpenAI Responses、Anthropic Messages の3つの互換レイヤーが文書化されています。
K3特有のリクエスト挙動は依然として重要です。K3は常に推論を行い、いくつかのサンプリングパラメータは固定であり、ビジョン入力では公開画像URLはサポートされません。

個人開発者や小規模なAIプロダクトチームにとっての実務的な要点はシンプルです。旧プロトタイプがMoonshot v1またはK2.xのモデルIDを使っていたなら、ベースURLを差し替えるだけで他も動くと期待しないでください。モデルIDを更新し、未対応の思考パラメータを削除し、スモークテストを実行し、コストと制限をあらためて検証してください。

OpenAI SDKでKimi K3を直接呼び出す方法

KimiのOpenAI互換設定では、Moonshot APIキーとKimiのベースURLを使ってOpenAI SDKを利用します。

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="kimi-k3",
    reasoning_effort="low",
    messages=[
        {
            "role": "user",
            "content": "Review this launch checklist and list the three riskiest gaps.",
        }
    ],
)

print(response.choices[0].message.content)

これで基本的なテキスト呼び出しには十分です。しかし、本番移行には十分ではありません。Kimi K3は、アプリで明示的にテストすべき点で、一般的なOpenAI互換モデルとは異なります。

省略してはいけないKimi K3のパラメータ

K3で最も重要なパラメータは reasoning_effort です。

Kimi K3では常に思考が有効になっています。これをオフにはできませんが、推論の強さは選択できます:

low は、低レイテンシの確認、下書き、分類、またはより安価な探索に適しています。
high は、レイテンシが許容できる、より難しい推論タスクに適しています。
max は、最も深いK3推論モードで、現在のデフォルトです。

Kimiのパラメータリファレンスによると、temperature、top_p、n、presence_penalty、frequency_penalty はK3では固定です。互換性のない値を渡すとエラーが返る場合があるため、現在のドキュメントで別途指示がない限り、これらのパラメータは省略してください。

マルチターンの会話やツール呼び出しでは、Kimi は、推論やツール呼び出しフィールドを含めて、API が返した完全な assistant メッセージをそのまま返送するように求めています。既存のアプリが message.content だけを保存しているなら、K3 をエージェントワークフローで評価する前に修正してください。

ビジョンと動画入力：対応フォーマットを使用する

Kimi K3 は視覚理解に対応していますが、入力形式は特定のものです。

画像メッセージでは、message.content は JSON 文字列ではなく、パーツの配列でなければなりません。Kimi のビジョンドキュメントは、base64 画像コンテンツとファイル ID 参照に対応しています。現在のところ、ビジョン入力として公開 URL 形式の画像はサポートしていません。

動画については、まずファイルをアップロードし、video_url パーツ内で ms://<file-id> 形式を使って参照します。Kimi は、動画解像度を FHD 以下に保ち、コストの高いマルチモーダルジョブの前にトークン見積もり API を使うことを推奨しています。

これはプロダクトチームにとって重要です。なぜなら、プロバイダーはチャットでは「OpenAI 互換」であっても、画像、動画、ファイルアップロード、制限、請求についてはプロバイダー固有のルールを持っている場合があるからです。

直接 Kimi API か Flatkey ルートか？

どちらのアプローチも有効です。適切な選択は、何を学びたいかによって決まります。

次の場合は直接 Kimi API を選びます：

K3 の Moonshot 固有機能に最も近い経路を使いたい;
アプリが主に複数モデルの比較ではなく Kimi K3 の評価を目的としている;
別のプロバイダーのアカウント、残高、キー、レート制限プロファイル、請求書を管理することに問題がない;
Kimi 固有のパラメーター処理をアプリケーションコード内に保持できる。

次の場合は Flatkey のようなマルチモデルゲートウェイを選びます：

Kimi K3 と GPT、Claude、Gemini、DeepSeek、Qwen、GLM、Seedance、その他の対応モデルを比較しながら、1 つの OpenAI 互換ベース URL を使いたい;
アプリにフォールバックルーティング、モデル許可リスト、利用ログ、クォータ制御、共有請求が必要である;
機能コードの外に、プロバイダー固有の認証情報やルートポリシーを移したい;
複数のプロバイダーにまたがって大量のトークンを消費する可能性があるコーディングエージェントや自動化ジョブで構築している。

Flatkey の公開モデルカタログでは、現在 kimi-k3 が OpenAI 互換エンドポイント प्रकारで利用可能として सूचीされています。OpenAI 互換リクエストに対する Flatkey の現在のルーターのベース URL は次のとおりです：

https://router.flatkey.ai/v1

対応する SDK 設定は次のとおりです：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

response = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {
            "role": "user",
            "content": "この 3 つのオンボーディングフローを比較して、最もリスクの低いリリース経路を選んでください。",
        }
    ],
)

print(response.choices[0].message.content)

本番利用の前に、そのルートがワークロードに必要な Kimi 固有のリクエストフィールドすべてをサポートしているか確認してください。互換性は統合を簡単にする手段であり、テストカバレッジの代わりではありません。

Kimi K3 の実践的な評価ワークフロー

実際のユーザーを Kimi 3 API ルートに移す前に、次の手順を使ってください：

モデル ID とアクセスを確認する。 現在のプロバイダーまたはゲートウェイのモデル一覧に kimi-k3 が表示されていることを確認し、アカウントに必要な残高またはルート権限があることを確認します。
プレーンテキストのスモークテストを実行する。 ツール、JSON モード、ストリーミング、長文コンテキスト、ビジョンを追加する前に、短い非ストリーミングのプロンプトから始めます。
実際のワークロードでテストする。 自社プロダクトの実際のプロンプトを使います。たとえば、コーディングエージェントのタスク、ドキュメント分析、サポート自動化、リサーチ、構造化抽出、マルチモーダルレビューなどです。
出力の受理率を測定する。 ベンチマークの主張だけに頼らないでください。ユーザー、レビュー担当者、または下流のパーサーが回答を受け入れるかどうかを追跡します。
レイテンシとトークン使用量を測定する。 K3 の長文コンテキストと推論は有用ですが、実時間と出力長にも影響する可能性があります。
パラメータの挙動をテストする。 固定のサンプリングパラメータを हटし、reasoning_effort を意図的に設定し、マルチターンセッションでは assistant メッセージ全体を保持します。
マルチモーダルの制約を確認する。 画像や動画には base64 またはファイルアップロードを使用し、大きなメディアジョブの前にトークンコストを見積もります。
フォールバックを定義する。 同じモダリティとレスポンス形状要件を持つフォールバックモデルを選びます。いつ再試行するか、可視的に失敗させるか、別ルートに振り分けるかを決めます。
利用ログを確認する。 モデル、ステータス、トークン、キャッシュ済みトークン、コスト、レイテンシ、所有者、環境を確認できることを確かめます。
1 つのワークロードから段階的に展開する。 まずは範囲を限定したワークロードで開始し、ルートが品質、信頼性、コストを満たすことが確認できてから拡大します。

古い Kimi アプリ向けの Kimi K3 移行チェックリスト

コードがすでに旧来の Kimi または Moonshot のモデル ID を使っている場合は、次を確認してください:

kimi-k2.5 や moonshot-v1-* などの終了済みモデル ID を kimi-k3 または他のサポートされている現行モデルに置き換えます。
K3 に移行する際は K2.x の thinking 設定を削除し、代わりにトップレベルの reasoning_effort を使用します。
サポートされていないサンプリングパラメータの送信をやめます。
マルチターンおよびツール呼び出しのフローでは、assistant メッセージを完全な形で保持します。
JSON スキーマ出力、tool-choice の挙動、ストリーミングパーサーの挙動、エラーハンドリングを再テストします。
現在の料金表に基づいて、キャッシュヒットとキャッシュミスの経済性を再計算します。
現在のチャージ階層に対するレート制限を再確認します。
ダッシュボード、アラート、ランブックを更新し、kimi-k3 が独立したモデルルートとして表示されるようにします。

Kimi 3 API のよくあるミス

誤ったモデル名を使う

kimi-3 ではなく kimi-k3 を使ってください。検索やユーザー向けの説明では「Kimi 3 API」という表現を維持します。

OpenAI 互換を同一だとみなす

OpenAI 互換とは、見慣れたリクエスト形式を再利用できるという意味です。モデルパラメータ、マルチモーダル処理、レート制限、usage フィールド、出力挙動が同一であることを保証するものではありません。

キャッシュミスを無視する

Kimi K3 の料金体系では、キャッシュヒットとキャッシュミスの input が分かれています。長文コンテキストのアプリでは、prefix の安定性にわずかな差があるだけでも実効コストが大きく変わる可能性があります。

ベンチマークのスクリーンショットだけで評価する

Kimi のローンチ資料にはベンチマークやアーキテクチャに関する主張が含まれていますが、本番導入の判断は、自社の受け入れテスト、レイテンシー予算、パーサー互換性、フォールバック動作に基づいて行うべきです。

長時間稼働するエージェントをセッション途中で切り替える

Kimi の技術ブログでは、K3 は思考履歴に敏感な場合があると警告しています。エージェントのワークフローでは、実行中のセッションを別のモデルから K3 に切り替える際は、会話状態をリセットして検証せずに行わないようにしてください。

FAQ

Kimi 3 は Kimi K3 と同じですか？

「Kimi 3」は一般的な検索フレーズです。Kimi K3 が公式のモデル名であり、開発者が使用すべき API のモデル ID は kimi-k3 です。

Kimi K3 API は今利用できますか？

はい。Kimi の現在のモデル一覧には kimi-k3 が含まれており、Kimi K3 ガイドでは Kimi API Platform を通じた直接の API アクセスが記載されています。

Kimi K3 のコンテキストウィンドウはどれくらいですか？

Kimi の現在のドキュメントでは、Kimi K3 のコンテキストウィンドウは 1,048,576 トークンと記載されています。

Kimi K3 API の料金はいくらですか？

Kimi の現在の推論料金ページでは、Kimi K3 はキャッシュヒットした入力トークン 100 万件あたり $0.30、キャッシュミスした入力トークン 100 万件あたり $3.00、出力トークン 100 万件あたり $15.00 と記載されており、適用される税金は含まれていません。モデル価格は変更される可能性があるため、予算を立てる前に料金ページを再確認してください。

Kimi K3 の reasoning を無効にできますか？

いいえ。Kimi K3 は常に reasoning を行います。reasoning_effort は low、high、または max に設定できます。

Kimi K3 は画像 URL をサポートしていますか？

Kimi K3 は vision 入力をサポートしていますが、Kimi の現在の vision ドキュメントでは、公開 URL 形式の画像はサポートされていないとされています。代わりに base64 の画像コンテンツまたはファイルアップロードを使用してください。

Kimi K3 を Flatkey 経由で呼び出せますか？

Flatkey の公開カタログでは現在、OpenAI 互換のエンドポイントタイプを通じて kimi-k3 が利用可能として掲載されています。1つのキー、1つのルーター基盤 URL、共有課金、利用可視化、複数のサポート対象モデルにまたがるルーティング制御を求める場合は Flatkey を使ってください。

次のモデル変更に備えて構築する

Kimi 3 API の検索トレンドは、実際にはより広い開発者の課題を反映しています。それは、モデルへのアクセスがアプリケーションアーキテクチャよりも速く変化するということです。

Kimi K3 は、長文コンテキストのコーディング、ナレッジワーク、深い推論、マルチモーダルタスクの評価に値します。しかし、長期的に有効なエンジニアリング上の対応は、プロバイダーの選択を設定可能に保ち、モデル固有の挙動を明示的にテストし、モデル実験がコードベース全体に広がる前にルーティング、利用、フォールバック、課金を一元化することです。

Flatkey は、サポート対象の公式モデルとツール全体で、1つの OpenAI 互換ルーター、1つの API キー、1つの残高、1つのダッシュボードをチームに提供することで、その運用モデルを支援します。まずは Flatkey API クイックスタートから始め、その後 kimi-k3 を、K3 の長いコンテキストと推論が実際に製品指標を改善できるワークロードと比較してください。