Kimi K3.1 Pro

使用公開模型 ID kimi-k3.1-pro。模型頁提供 Playground 與即時價格。下載 OpenAPI 規範，查看完整的巢狀請求和回應結構。

快速開始

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"kimi-k3.1-pro",
    "messages":[{"role":"user","content":"How can an idempotency key prevent a duplicate payment?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

原生格式

使用 Authorization: Bearer $SEEDROUTER_API_KEY。Messages 還需使用 anthropic-version: 2023-06-01。各格式傳回原生 JSON 或 SSE 事件。Responses 無狀態：需重放完整紀錄；請求不支援 previous_response_id 欄位。

請求參數

Playground 中留空的欄位不會傳送。在合法情況下，明確指定的 false 和零會被保留。省略不等於允許 null。未知的最上層擴展欄位會被捨棄，無效的官方欄位會被拒絕。巢狀工具結構和傳回的紀錄保持完整。

Chat Completions

Responses

Messages

Chat 有 22 個最上層欄位：model、五個固定取樣欄位和 16 個可變輸入。Responses 為 model 加 12 個輸入；Messages 為 model 加 10 個輸入。Playground 隱藏固定的 model 和取樣控制項。

推理與輸出上限

思考始終啟用。Chat 的 reasoning_effort、Responses 的 reasoning.effort 和 Messages 的 output_config.effort 均接受 low、high 或 max，預設 max。所有輸出上限均包含推理。Chat 和 Responses 預設輸出 131,072 token，上限為 1,048,576。Messages 必須提供正數 max_tokens。Chat 接受已棄用的 max_tokens；新串接建議使用 max_completion_tokens。

上下文視窗為 1,048,576 token，輸入本身必須處於視窗內。當輸入加生成預算超過視窗時，服務可將預算縮減至剩餘空間。輸出上限較小時，可能尚未出現可見回答就已停止。

Chat 取樣值固定：temperature:1、top_p:0.95、n:1、frequency_penalty:0、presence_penalty:0。其他值無效。停止序列按文字精確相符，且不包含在回答中。32 位元組上限按 UTF-8 位元組計數，並非按字符計數。

結構化輸出與預測輸出

Chat 的 response_format.type 接受 text、json_object 或 json_schema。JSON 模式還需在提示詞中要求傳回 JSON。JSON Schema 必須提供 json_schema.name 和 json_schema.schema；strict 預設為 true。

Responses 使用 text.format，包含 type:json_schema、schema，以及可選的 name 和 strict。Messages 使用 output_config.format，包含 type:json_schema 和 schema。請遵循 Moonshot Flavored JSON Schema，不應假設所有通用 JSON Schema 擴展都會被強制執行。請在應用中驗證完成後的輸出。

Chat 預測輸出使用 prediction:{type:"content",content:...}。content 為字串或僅含文字的內容區塊。適用於大部分內容已知的輸出，例如只需少量修改的文件。

工具與完整對話紀錄

Chat 工具使用 type:function，並提供 function.name 和 function.parameters。可選欄位包括 description 與 strict（預設 true）。名稱須相符 ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$。工具選擇支援 auto、none 和 required；required 至少需要一個可用工具。強制呼叫指定名稱的函式與始終啟用思考衝突。

動態 Chat 工具訊息為不帶 content 的 {role:"system",tools:[...]}。請在對話中保留這些訊息。追加完整的 assistant 回復，包括 reasoning_content 和 tool_calls，再將各工具結果作為帶有相符 tool_call_id 的 role:tool 訊息傳回。assistant 工具回復的 content 可以為 null，其他訊息角色仍需提供 content。

Responses 支援原生 function、namespace、apply_patch 自訂工具和 web_search 工具定義，並使用 tool_choice:"auto"。傳回帶有相符呼叫 ID 的 function_call_output 或 custom_tool_call_output 條目。include 值 web_search_call.results 和 web_search_call.action.sources 僅影響網頁搜尋輸出。

Messages 支援原生工具定義，以及 type 為 auto、any 或 none 的工具選擇物件。保留 assistant 思考塊及其簽名，在 user 訊息中傳回工具結果塊。應用負責驗證參數、執行自訂函式，並控制外部操作。

Chat Partial Mode 只在最後一條 assistant 訊息上設定 partial:true。Messages 直接續寫最後一條 assistant 訊息。不要僅從可見回答重建紀錄。

媒體約束

Chat 接受文字、image_url 和 video_url 內容區塊。使用 base64 data URL 或認可的 ms:// 引用；不支援任意公開媒體 URL。圖片格式：JPEG、PNG、GIF、WebP、BMP、HEIC 和 HEIF。影片格式：MP4、MPEG、MOV、AVI、FLV、MPG、WebM、WMV 和 3GPP。官方指南規定請求體總上限為 100M，未單獨限製圖片數量。4K 圖片和 Full HD 影片是建議，並非強制限制。

Responses 使用帶 data URL 的 input_image.image_url。Messages 使用圖片來源，例如 {type:"base64",media_type:"image/png",data:"..."}，或使用 type 為 url、帶認可的 ms:// 引用的來源。Messages 內嵌圖片類型為 JPEG、PNG、GIF 和 WebP。不能由此推斷這些格式支援 Chat 的影片塊，請使用各自專用結構。

Playground 附加的是內嵌圖片。影片塊和文件引用請使用原生對話欄位或 JSON 編輯器。文件上傳與管理不屬於這些生成端點。其他帳戶創建的文件 ID 不一定可用。

快取與用量

Chat 和 Responses 使用 prompt_cache_key 與 prompt_cache_options:{mode:"implicit",ttl:"5m"}。TTL 接受 5m 或 1h，預設 5 分鐘。Messages 使用最上層 cache_control:{type:"ephemeral",ttl:"5m"} 與可選的 metadata.user_id。巢狀的 Messages 快取控制標記會被忽略。內容層級的 prompt_cache_breakpoint 無效。

已有快取前綴在刷新時保留原始 TTL。請求不同的有效期不能證明其已生效。Chat 官方快取寫入回應頭報告實際的 5 分鐘和 1 小時數量。Responses 可傳回實際採用的 prompt_cache_options；Messages 在 usage.cache_creation 中報告兩個 TTL 的計數。

Chat 和 Responses 的輸入總數已包含快取讀取與寫入。這些類別與未使用快取的剩餘部分互不重疊，不要重複累加快取 token。輸出包含推理。Messages 將寫入拆分為 ephemeral_5m_input_tokens 和 ephemeral_1h_input_tokens。查看即時費率；公開生成回應不包含金額費用。

流式輸出與完成狀態

設定 stream:true。Chat 傳送資料區塊和 [DONE]；stream_options.include_usage:true 用於請求最後的用量資料區塊。Responses 使用 response.output_text.delta、response.completed 和 response.incomplete 等命名事件。Messages 使用 message_start、內容區塊事件、message_delta 和 message_stop。

連接關閉本身不能證明生成完成。請檢查原生結束原因和終止狀態。流中斷時可能缺失最終用量。停止讀取不保證生成已取消。

官方參考資料

查核於 2026 年 10 月 25 日：Kimi K3.1 Pro 指南、Chat、Responses、Messages、視覺與快取。