blog

Kimi K3.1 Pro 接入 pirouter:思考关不掉,采样参数不生效

pirouter 已接入 Kimi K3.1 Pro:始终推理,temperature、top_p 与 penalty 会被剥离,不支持指名强制某个工具。输入 $2、缓存读 $0.20、输出 $10/百万 tokens,不参加六折活动。

PiRouter Team约 5 分钟
Kimi K3.1 Pro 请求中的推理、采样参数与工具选择边界

Kimi K3.1 Pro 已于 10 月 28 日接入 pirouter,也是本站首次接入 Kimi。它始终开启推理,客户端传入的 temperature、top_p 与重复惩罚类参数(penalty)会被网关剥离,不会改变上游采样设置。此外,不支持指名强制某个工具,且本模型不参加六折活动。

这些是本站当前接入的使用边界,不是对所有 Kimi 产品或厂商直连接口的统一说明。接口能接通,并不表示客户端里每个默认字段都会生效。

本站 Kimi K3.1 Pro 模型页列出的上下文为 1,048,576 tokens、最大输出 131,072 tokens,支持图片输入、结构化输出及工具调用;可通过 OpenAI 和 Anthropic 协议调用。先核对你实际要用的能力,再决定哪些旧参数值得保留。

Kimi K3.1 Pro 始终推理,disabled 不会关掉思考

本站提供的推理强度从 low 起,最高 max,默认 medium,没有可用的“不思考”档。降低强度可以表达你的推理偏好,但不能把它当成关闭推理,更不能据此承诺固定的响应时间或费用。

使用 Anthropic 协议的客户端还要注意:如果请求带有 thinking: {"type": "disabled"},网关会移除这个关闭字段,模型仍然推理。这里做的是兼容处理,不是实现了关闭功能;请求没有因此报错,也不能作为“思考已关闭”的证据。

因此,一个界面上的 thinking 开关,不一定对应这个模型实际具备的控制项。若应用必须使用不推理模式,应重新选择满足该条件的模型,而不是靠反复发送 disabled 来期待另一种结果。协议与模型可用范围可核对模型文档:支持的协议。

temperature、top_p 和 penalty 会被剥离

不少客户端会给每次请求默认附上采样设置,即使使用者从未调整过它们。对本站的 K3.1 Pro,这些值不会传给上游改变采样:temperature、top_p 和各类 penalty 会在转发前被移除,上游使用固定设置。

这意味着,把 temperature 从一个值改到另一个值,再比较两次答案,不能据此声称完成了采样温度对比。答案有变化,不足以证明字段生效;答案相似,也不足以证明输出完全确定。

公开参考要按层次读。Chat Completions 接口参考描述的是通用请求参数,而这个模型页的受支持参数列表没有 temperature 与 top_p。通用接口里存在某个字段,不会让模型级限制消失。

实用的处理是从模型专用配置中移除这些无效项,避免日志看起来像“应用控制了采样”,实际却没有。也不要把不同模型共用的一份参数模板,当成逐项兼容的保证。

PiRouter编辑配置卡:Kimi始终推理、采样字段被过滤,支持工具调用但不能指名强制函数;disabled处理仅指Anthropic协议。
PiRouter编辑整理的本站接入行为,非官方UI或本轮请求实测。Anthropic协议的thinking disabled被移除并不关闭推理,采样项被剥离;支持工具调用不等于支持指名强制函数。来源:本站Kimi K3.1 Pro模型资料、pirouter模型文档:协议与能力、Chat Completions接口参考

支持工具调用,不代表能强制指定某个工具

K3.1 Pro 可以调用工具,但本站当前不支持用 tool_choice 指名强制某一个函数。这里限制的是指定选择的语义,不是说整个工具机制不可用。

OpenAI 函数调用文档:工具选择区分自动选择、要求至少调用一个函数,以及强制调用指定函数。这里引用的是字段语义,不是用 OpenAI 文档证明 Kimi 支持这些选项;实际可用取值仍以本站这个模型的接入限制为准。

模型页的通用受支持参数列表仍出现 tool_choice,也不应据此推出所有取值都能使用。参数名、具体取值与模型能力是三层问题;看到字段名就复制一段“必须调用这个函数”的旧请求,容易在这一层碰到限制。

如果业务要求只允许某类动作,可以收窄暴露给模型的工具集合,并在应用端校验工具名和参数。但这只能限制可执行的动作,不保证模型一定发起你指定的调用。必须执行的业务步骤,应由应用流程负责,不要让一个不受支持的强制选项承担保证。

Kimi K3.1 Pro 按标价计费,不参加六折

本站当前价格如下,单位为美元/百万 tokens:

计费项当前单价
输入$2.00
缓存读取$0.20
输出$10.00

推理 tokens 按输出单价计费。本模型没有活动折扣,不参加其他模型的六折活动;不能看到站内有促销,就把这张表再乘一次六折。

首次接入时,可以先保留最小请求体,发往 POST https://api.pirouter.ai/v1/chat/completions,再逐项增加业务需要的功能:

{
  "model": "moonshotai/kimi-k3.1-pro",
  "messages": [
    { "role": "user", "content": "Summarize this requirement briefly." }
  ]
}

这是依据公开接口整理的示例,本文没有执行付费 API 调用。模型的裸别名 kimi-k3.1-pro 与 kimi-k3-1-pro 也可使用;完整 ID 更便于在配置中明确对象。

接通后,按定价与计费:单次请求费用查看日志中的输入、输出、缓存和推理用量。不要只凭最终可见答案很短,就把推理开销当作零;也不要只看到请求成功,就断定旧参数全部被采用。

如果你要处理的是 K2 退役与渠道迁移,另见Kimi K2 限制与 K3.1 接入路径。本次接入先把四件事写进模型配置:推理保持开启,采样参数不控制上游,不指名强制工具,预算按无折扣单价计算。