Kimi K3.1 Pro API

Kimi K3.1 Pro 多模態推理模型，支援 1M 上下文、文本與視覺理解、函式呼叫。快取寫入分 5 分鐘與 1 小時計價，思考 Token 包含在輸出用量中。

模型名: kimi-k3.1-pro
厂商: Moonshot
类型: chat

POST /v1/chat/completions

使用對話補全格式呼叫 Kimi K3.1 Pro，支援流式、快取與函式工具。

最小文本请求

必填参数: model, messages

可用参数: model, stream, messages, max_tokens, reasoning_effort, stream_options, prompt_cache_options, tools, tool_choice

请求参数

参数	类型	必填	说明
`model`	string	是	必填，固定为本页模型名称。可选: kimi-k3.1-pro
`stream`	boolean	否	是否返回 SSE 事件流。
`messages`	array	是	必填，按时间顺序提供 system/user/assistant/tool 消息。tool 结果需携带原 tool_call_id；assistant 工具调用和思考内容原样保留。
`max_tokens`	integer	否	输出预算含思考；过小可能无可见正文。
`reasoning_effort`	string	否	思考力度；low 不表示关闭思考。可选: low / high / max
`stream_options`	object	否	流式建议启用 include_usage。
`prompt_cache_options`	object	否	自动缓存配置；省略时默认 implicit、5m。短前缀可能没有缓存读写，不能通过省略参数禁用创建。
`tools`	array	否	客户端函数工具定义；每项为 type=function、function{name,description,parameters}。
`tool_choice`	string \| object	否	按所选协议的官方本模型工具选择格式填写。

用量核对： - Chat 的 prompt_tokens、Responses 的 input_tokens 已包含普通输入、缓存读取、缓存创建三个互不重叠部分。 - Messages 的 input_tokens 仅为普通输入，总输入需加 cache_read_input_tokens 与 cache_creation_input_tokens。创建总量等于 cache_creation 中 5m 与 1h 两部分之和。 - Chat／Responses 的 usage 可能仅报告创建总量，TTL 拆分由响应元数据提供；Messages 可直接报告 cache_creation 两类细分。不能用请求的 TTL 代替实际响应。 - 思考量已计入输出总量，不能重复累加。流式以最终累计 usage 为准，首帧零值或中间 usage=null 不能代表最终零消耗。 - 字段返回 0 表示已报告为零，字段缺失表示未报告。错误与中断时以实际报告用量和账单记录为准。官方参考： - [Kimi 模型价格说明](https://platform.kimi.ai/docs/pricing/chat) - [缓存参数与用量说明](https://platform.kimi.ai/docs/guide/context-caching) - [Chat Completions 官方参考](https://platform.kimi.ai/docs/api/chat) - [Responses 官方参考](https://platform.kimi.ai/docs/api/responses) - [Messages 官方参考](https://platform.kimi.ai/docs/api/messages) 通过本站调用时使用本页请求域名和路径。服务行为与示例说明： - 5m 与 1h 选择影响创建缓存的有效期，不代表请求发出后必然创建或命中。 - 只把实际 usage 中报告的读取、创建、TTL 细分当作本次测量；缺失字段不等于明确零。 - 缓存创建与普通输入互斥，输出已包含思考；客户端不要把累计帧重复相加。 - 流式用量可分散在首帧和末帧：输入与缓存先到、输出后到时，分别保留各维度最后一次明确报告的累计值。字段缺失或 usage=null 不清空已知值，重复累计帧不相加。 - 不同接口的工具定义和回传格式分别遵守本页说明；未执行函数工具或图片请求的文本例子不构成这些功能的实测承诺。

请求示例

curl --request POST https://api.router.ai/v1/chat/completions \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $ROUTER_API_KEY" \
  --data '{
  "model": "kimi-k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "这是虚构示例，请只回复：你好。"
    }
  ],
  "max_tokens": 256,
  "reasoning_effort": "low",
  "stream": false
}'

接口通用说明: 建立對話請求 (OpenAI 相容)

POST /v1/responses

使用 Responses 格式呼叫 Kimi K3.1 Pro，支援流式、快取與函式工具。

最小文本请求

必填参数: model, input

可用参数: model, stream, input, instructions, max_output_tokens, reasoning, text, prompt_cache_options, tools, tool_choice

请求参数

参数	类型	必填	说明
`model`	string	是	必填，固定为本页模型名称。可选: kimi-k3.1-pro
`stream`	boolean	否	是否返回 SSE 事件流。
`input`	string \| array	是	必填，文本或输入项数组；函数结果使用 function_call_output。
`instructions`	string	否	系统指导文本。
`max_output_tokens`	integer	否	输出预算包含思考与正文。
`reasoning`	object	否	本模型始终思考。
`text`	object	否	结构化输出配置，按官方 text.format 填写。
`prompt_cache_options`	object	否	自动缓存配置；省略时默认 implicit、5m。短前缀可能没有缓存读写，不能通过省略参数禁用创建。
`tools`	array	否	客户端函数工具定义；每项将 type=function、name、description、parameters 放顶层，不使用 Chat 的 function 外层。
`tool_choice`	string \| object	否	按所选协议的官方本模型工具选择格式填写。

请求示例

curl --request POST https://api.router.ai/v1/responses \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $ROUTER_API_KEY" \
  --data '{
  "model": "kimi-k3.1-pro",
  "instructions": "你是虚构示例助手。",
  "input": "请只回复：你好。",
  "max_output_tokens": 256,
  "reasoning": {
    "effort": "low"
  },
  "stream": false
}'

POST /v1/messages

使用 Messages 格式呼叫 Kimi K3.1 Pro，支援流式、快取與函式工具。

最小文本请求

必填参数: model, messages, max_tokens

可用参数: model, stream, messages, max_tokens, system, output_config, cache_control, tools, tool_choice

请求参数

参数	类型	必填	说明
`model`	string	是	必填，固定为本页模型名称。可选: kimi-k3.1-pro
`stream`	boolean	否	是否返回 SSE 事件流。
`messages`	array	是	必填，user/assistant 消息；工具结果使用 user 的 tool_result 块，tool_use_id 对应原调用 id。
`max_tokens`	integer	是	必填，输出预算含思考和正文。
`system`	string \| array	否	系统指导，不放入 messages 的 system 角色。
`output_config`	object	否	思考力度在本对象的 effort 设置，不使用 Chat 顶层 reasoning_effort。
`cache_control`	object	否	仅顶层生效；内容块内的标记不改变本模型 TTL。省略为 5m。
`tools`	array	否	客户端函数工具定义；每项包含 name、description、input_schema。
`tool_choice`	string \| object	否	按所选协议的官方本模型工具选择格式填写。

请求示例

curl --request POST https://api.router.ai/v1/messages \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $ROUTER_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
  "model": "kimi-k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "这是虚构示例，请只回复：你好。"
    }
  ],
  "max_tokens": 256,
  "output_config": {
    "effort": "low"
  },
  "stream": false
}'

接口通用说明: 建立訊息請求 (Claude 原生)