在 TopxAI 升级到 Claude Sonnet 5.5

2026-10-02 · anthropic, models, api, topxai

更新 Sonnet 模型 ID，沿用原来的输入、输出与缓存价格，并核对 Claude Code、SDK 的思考模式和工具参数。

在 TopxAI 的 Claude 共享池和官方线路上使用 claude-sonnet-5-5，上游模型 ID 也是这个名字。Sonnet 5 的输入、输出和缓存价格全部沿用；旧 ID claude-sonnet-5 退出目录，不转发到新模型。

更新客户端和密钥

把 SDK 或编码客户端里保存的模型 ID 换成新值。基础地址无需调整，没有模型限制的密钥也能继续使用。设有允许模型列表的密钥，请另外编辑该列表；只改客户端模型名不会扩大密钥权限。

Claude Code 用户应更新 shell 或 ~/.claude/settings.json 中的 ANTHROPIC_MODEL，以及自己配置过的 ANTHROPIC_DEFAULT_SONNET_MODEL：

export ANTHROPIC_BASE_URL=https://ai.topxea.com
export ANTHROPIC_AUTH_TOKEN=$TOPXAI_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
claude

长期设置方法见 Claude Code 接入文档。直接调用 Messages 接口可以这样写：

curl https://ai.topxea.com/v1/messages \
  -H "x-api-key: $TOPXAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":4096,"output_config":{"effort":"medium"},"messages":[{"role":"user","content":"分析这个 API 设计的取舍。"}]}'

五项价格都不变

以下为默认美元价格，单位是每百万 token，依据 2026 年 10 月 2 日核对的 Anthropic 模型页：

类别	共享池	官方线路	Anthropic 官网价
输入	$1	$1.80	$2
输出	$5	$9	$10
缓存读取	$0.10	$0.18	$0.20
缓存写入，5 分钟	$1.25	$2.25	$2.50
缓存写入，1 小时	$2	$3.60	$4

共享池为牌价的 50%，官方线路为 90%，两档缓存写入也按同一比例。没有长上下文溢价。Sonnet 5.5 支持 100 万 token 上下文及最多 12.8 万输出 token。实际费用按上游返回的 token 类别及请求受理时保存的价格计算，缓存未命中不等于自动写入缓存。模型页和用量日志分别列出适用价格和计费数量。

核对思考模式

不传 thinking 时，Sonnet 5.5 默认使用自适应思考，推理强度为 high。自适应模式支持 low、medium、high、xhigh 和 max。思考 token 计入输出上限，也按输出价格收费。

TopxAI 将旧版 thinking: {"type":"disabled"} 或 OpenAI 的 reasoning.effort: "none" 转换为 between_tools 加 low。这会关闭回答前的思考，保留工具调用之间的简短进度更新。手动 budget_tokens 设置会转换为 effort 档位。

如果直接传原生 thinking: {"type":"between_tools"}，effort 只能使用 low、medium 或 high，该模式不能附带 display、budget_tokens 或其他 thinking 子字段。需要 xhigh、max，或者 display: "summarized" / "updates" 时，应使用自适应模式；自适应模式的这些 display 设置会保留。

读取回复时应按内容块的 type 分别处理。工具对话里的原生 thinking 内容块和签名需原样带回。已有思考状态属于原来的模型，agent 从 Sonnet 5 换到 5.5 时请开启新对话。

核对采样和工具参数

Sonnet 5.5 不支持 temperature、top_p、top_k，TopxAI 会在转发前移除这些设置。强制工具选择（any / 指定 tool，或 OpenAI 的 required / 指定函数）返回 400 且不收费。请使用 auto，原生 tool_use / tool_result 对话与思考签名会保留。

使用 Anthropic 内置计算机工具的客户端，需要迁移到新的官方 toolset 格式；普通自定义工具沿用原来的定义。上游变更详见 Anthropic 的迁移指南，上文的参数转换则是 TopxAI 提供的兼容行为。

10 月 2 日供应商实测中，部分 between_tools 请求返回 502，包括两条线路的 medium，以及官方线的 OpenAI none。两条线路的显式 low adaptive 模式已通过实测：如符合你的任务，可在 Messages 使用 thinking: {"type":"adaptive"} 配合 output_config: {"effort":"low"}，或在 Chat Completions 使用 reasoning_effort: "low"。Adaptive 模式仍可能在回答前思考，这部分 token 按输出计费。TopxAI 保留请求的思考模式，不会悄悄换成另一种模式。

模型：claude-sonnet-5-5 · 模型与价格

在 TopxAI 升级到 Claude Sonnet 5.5

更新客户端和密钥

五项价格都不变

核对思考模式

核对采样和工具参数

相关