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 | 多輪及工具呼叫須原樣回傳完整 assistant 消息，包括思考內容和 tool_calls |
messages[].partial | Kimi Partial Mode 擴展：末條 assistant 消息設為 true，從已給出的前綴繼續生成；不要與 response_format.type=json_object 混用 |
messages[].tools | 動態工具擴展，官方指南列出 kimi-k3.1-pro、kimi-k3：追加一條含完整工具定義的 system 消息，且不能包含 content；工具從該位置起可見，後續請求須保留這條消息 |
| 欄位 | 差異說明 |
|---|
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；不傳時仍按 5 分鐘 TTL 讀寫快取 |
| 推理強度 | 切換檔位會破壞前綴快取命中，建議在工作階段開始前確定 |
ms:// 是 Kimi 原廠檔案引用格式，需先在原廠上傳檔案；本頁不提供 AGTCloud 檔案上傳接口。
將 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"}
}'