Kimi のパラメーターとプロトコルの違い
互換プロトコルにおける Kimi のパラメーターの違いと使い方を確認します。
Kimi は本ページに従って選択したプロトコルのパラメーターを調整してください。完全な構造は Chat Completions、Responses、Messages を参照してください。
| モデル | 適用範囲 |
|---|
| kimi-k3.1-pro、kimi-k3.1-pro-highspeed、kimi-k3 | 下記三プロトコルの共通ルール。個別拡張の対象モデルは各行に記載 |
| フィールド | 差分の説明 |
|---|
temperature、top_p | それぞれ 1.0、0.95 に固定。省略を推奨。それ以外はエラー |
n、presence_penalty、frequency_penalty | それぞれ 1、0、0 に固定。それ以外はエラー |
reasoning_effort | low/high/max に対応し、既定値は max。思考と保持型思考は常に有効。K2.x の thinking スイッチは使用しない |
max_completion_tokens | 既定値は 131072、最大 1048576。入力と出力予算の合計がコンテキスト上限を超えると出力予算を自動縮小。入力自体は上限内である必要がある |
stop | 最大 5 文字列、各 32 バイト以下 |
tool_choice | auto/none/required に対応。関数を指定するオブジェクト形式は思考と併用できず 400 を返す |
messages[].reasoning_content | 複数ターンやツール呼び出しでは、思考と tool_calls を含む assistant メッセージ全体を変更せず再送 |
messages[].partial | Kimi Partial Mode 拡張。末尾の assistant メッセージに true を指定してプレフィックスから継続。response_format.type=json_object とは併用しない |
messages[].tools | 動的ツール拡張。公式対象は kimi-k3.1-pro、kimi-k3。全ツール定義を含み content を含まない system メッセージを追加。そこからツールが可視となり、後続リクエストでも保持する |
| フィールド | 差分の説明 |
|---|
reasoning.effort | low/high/max に対応。既定値は max |
max_output_tokens | 既定値は 131072、最大 1048576 |
tool_choice | auto のみ対応 |
tools[].type | function/namespace/custom/web_search のみ対応。custom ツール名は apply_patch のみ |
text.format | type: "json_schema" と schema を使用。name の省略時は output |
| 応答内の会話状態フィールド | store と background は false、previous_response_id と conversation は null に固定。サーバー保存の応答チェーンに依存せず、クライアントで過去の入出力を再送 |
| フィールド | 差分の説明 |
|---|
max_tokens | 必須。最小 1。0 は不可 |
output_config.effort | low/high/max に対応。既定値は max |
tool_choice.type | auto/any/none に対応。既定値は auto |
stop_sequences | 最大 5 文字列、各 32 バイト以下 |
過去の thinking ブロック | signature とともに、次の assistant メッセージへ変更せず戻す |
output_config.format | 構造化出力では type: "json_schema" と schema が必須 |
| フィールド | 差分の説明 |
|---|
Chat／Responses の prompt_cache_options | mode は implicit のみ対応。ttl は 5m/1h に対応し既定値は 5m。省略しても既定で 5 分間のキャッシュを書き込む |
Chat／Responses の prompt_cache_breakpoint | 明示的ブレークポイントは非対応。コンテンツ内に指定すると 400 |
Messages の cache_control | リクエスト直下の設定のみ有効。messages 内のマーカーは無視。type は ephemeral 固定、ttl は 5m/1h に対応し既定値は 5m。省略しても TTL 5 分で読み書きする |
| 推論の深度 | 深度変更はプレフィックスキャッシュのヒットを妨げるため、会話開始時に決定 |
ms:// は Kimi ネイティブのファイル参照形式で、事前に Kimi へアップロードが必要です。本ページは AGTCloud のアップロード API を提供するものではありません。
MODEL_ID を選択したプロトコルで利用可能な完全なモデル ID に置換し、自分の API Key を使用してください。
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API のタイムアウトの調査方法を三点で説明してください"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096,
"prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
}'