参数如何被处理

每个参数到达模型背后的线路时只有四种结局：原样带过去、翻译为该线路接受的写法、由平台模拟、明确告知（去掉并留痕，或返回 400）。平台不会在不告知的情况下丢弃参数。

三种格式（对话补全、Messages、Responses）共用这套规则，各接口的字段表见对应页面。参数能否带到线路上，由模型声明的能力与请求规则、本次所走入口的协议、线路的画像共同决定，由管理员在后台维护。GET /models 返回每个模型的能力自述，见模型能力自述，接入前可先读取。

默认分级不符合需要时，带请求头 X-SciRouter-Unsupported-Params：

其他取值视为未带。三种格式均识别该请求头。

每个标准参数一行：三种格式中的写法、类别、各协议入口的处理方式，以及无法带到时的结局。处理方式的取值：

一条线路可以有多个入口（同一个上游账号接入的多种协议），每次调用按调用方的格式选择入口：有可原样处理该格式的入口时走该入口，否则走主入口并转换，见多厂商差异「字段生效规则」。表中的列为入口的协议：openai 与 custom 合为一列，anthropic、gemini 各一列。

表外的键（厂商私有参数）：走 openai 或 custom 入口时原样带过去，写法见多厂商差异「厂商专有参数」；走 anthropic 或 gemini 入口时去掉并留痕（留痕中记为 other，不记录键名）。

线路级的上下文窗口也在线路层判断：放不下的线路被跳过，全部放不下时返回 400 context_window_exceeded，details.scope 为 endpoint。

400 unsupported_param 的错误体如下（OpenAI 格式；Anthropic 格式见错误码）：

{
  "error": {
    "message": "参数 logprobs 带不过去：这个模型没有声明对应的能力",
    "type": "invalid_request_error",
    "code": "unsupported_parameter",
    "scirouter_code": "UNSUPPORTED_PARAM",
    "param": "logprobs",
    "request_id": "req_88a1",
    "details": { "param": "logprobs", "reason": "unsupported_param", "cause": "feature_missing" }
  }
}

code 为原厂兼容值，供现有客户端识别；平台码在 scirouter_code；param 为登记表中的参数名。此类错误在预扣之前返回，不扣费、不占并发名额。

OpenAI 格式的 reasoning_effort、Messages 的 thinking、Responses 的 reasoning.effort 归一为同一个意图，再按模型的思考能力（GET /models 的 reasoning：支持的控制方式、强度档位、能否关闭）落到线路上：

强度翻译成思考预算时（以预算控制思考的模型），预算与 max_tokens 一起确定：未填写 max_tokens 时取预算加 4096，不超过模型与套餐的输出上限；预算不超过 max_tokens 减去 1024 与 max_tokens 四分之一中的较大者；预算不足 1024 时不开启思考，留痕 budget_below_min。Anthropic 格式的请求被平台截短 max_tokens 时，不小于截短后上限的 thinking.budget_tokens 降到该上限减 1。上一轮的思考块与签名只交还给签发它的厂商，其他厂商无法识别，见 Messages。

契约类参数线路不接受时，平台在请求侧修改、在响应侧补全，使返回的形状与请求一致：

不模拟的参数：n > 1、logprobs、logit_bias、音频输出，以及对不支持工具调用的线路用提示词模拟工具调用。这些参数无法生成相同的结果，或会产生误导。

结构化输出经模拟时，如需确认结果是否符合 schema，带请求头 X-SciRouter-Validate-Schema: 1。平台按 schema 校验最终正文一次，结果写入扩展块 scirouter.schema_valid（true / false）；不符合时不重试、不报错，由调用方决定是否重发。走原生结构化输出的调用不校验（由厂商保证），不返回该字段。

有参数被去掉、翻译、模拟、整形或自愈时，以下三处均有记录，内容相同：

X-SciRouter-Param-Actions: dropped=seed,top_k; translated=reasoning(xhigh→high); emulated=response_format

{
  "param_actions": { "dropped": ["seed", "top_k"], "translated": ["reasoning(xhigh→high)"], "emulated": ["response_format"] }
}

没有任何动作时，该响应头与字段均不出现。参数门有「只观察」与「生效」两档：只观察期间动作不生效、请求按原样发出，但该响应头与扩展块照常返回。切换到生效之前平台会发布公告，调用方可先根据响应头评估自身调用受到的影响。

出站前平台按本次所走入口的协议整理消息列表与工具定义。每条规则对应一条留痕（reshaped=<规则>），处理结果是确定的：同一请求整理两次逐字节相同，不影响提示词缓存。整形规则：

• 补上缺失的工具结果；
• 丢弃没有对应调用的工具结果；
• 去重 tool_call_id；
• 工具名不符合线路要求时改写，响应中换回原名；
• 对不接受 developer 角色的线路，将其改为 system；
• 只保留 function 类工具；
• 没有 tools 时去掉 tool_choice；
• 去掉 Claude Code 的归因块。

改写历史的三条（补上、丢弃、去重）默认开启，平台可逐条关闭。原样转发到 Anthropic 入口的 Messages 请求一律不改写历史，只追加。

线路背后的服务明确报错不支持参数 X（平台从报错中识别出参数名）时：

无法识别参数名的上游 400 仍为 validation_failed（details.source 为 upstream，厂商原文在 details.provider_error 中）。

发出之前平台估算一次。输入超出模型的上下文窗口，或输入未超出、但加上调用方显式给出的 max_tokens 后超出时，返回 400 context_window_exceeded，不预扣、不占名额：

两种情况的 message 不同（见错误码），Claude Code 等客户端据此分别压缩历史或调小 max_tokens 后重发。

• 只计入显式给出的 max_tokens。未给出时，走 OpenAI 兼容入口不发送该字段，由厂商自行决定。
• 估算按模型的分词器族校准，取偏小的一侧，使估算值不超过实际值；没有分词器族信息的模型只拒绝明显超出的请求；未填写窗口的模型不预检。
• 线路级的窗口（自部署服务的窗口常小于模型的窗口）在选择线路时过滤，全部放不下时返回同一个 code，details.scope 为 endpoint。
• 上游报告超长时同样归为该 code：details.semantic 为 context_window_exceeded，厂商文案含数字时才带 limit 与 estimated，不含时不推算。

模型的窗口见模型中心的详情页。

GET /models 与 GET /models/{model_id} 的 scirouter 扩展字段列出模型当前接受的参数：

字段的格式见模型列表。

模型陷入复读（同一段内容反复出现）时，平台中断上游，finish_reason 为 length（各格式均有该取值），扩展块 scirouter.finish_detail 为 repetition，用于区分达到上限与被平台中断。