claude-sonnet-5 API
Claude Sonnet 5 是 Anthropic 面向计划、工具调用和持续执行的 Sonnet 版本,可用于编码与知识工作。它采用自适应思考,现属官方可用旧版;XiuAI 接入应核对参数迁移、当前费用及后续版本选择。[1][2][4]
claude-sonnet-5模型概览
供应商公开规格;实际调用范围以当前接口为准。
- 接口
- OpenAI-compatible API / openai-response / openai-response-compact / Anthropic Messages / Gemini GenerateContent / openai-alpha-search
计划与持续执行
发布说明重点是从制定计划到调用工具、检查结果的执行能力。可用于多步骤编码、资料检索后的综合分析或有明确完成条件的业务辅助;应用需要提供工具与状态保存,不由模型自动获得执行权限。[2]
与较早 Sonnet 版本比较时,重点观察任务能否完整结束、工具返回是否正确处理、输出是否满足你的要求。官方基准中接近某个 Opus 型号,不代表所有任务效果相同。[2]
自适应思考与采样参数
Sonnet 5 使用 effort 调整自适应思考深度。当前官方文档说明,传 temperature、top_p 或 top_k 会返回 400;旧应用的统一采样参数应按模型拆分,不能把所有型号视作同一请求契约。[1]
API 接入
在 XiuAI 接入与迁移
使用准确 ID claude-sonnet-5,并按照当前协议填写消息、工具和思考字段。准备迁移到 5.5 时,额外检查强制 tool_choice 与关闭思考的旧写法;兼容协议字段不能直接等同于 Anthropic 原生字段。[4][3]
总费用由输入、输出、缓存及多轮调用共同决定。发布说明中的表现和原厂定价用于理解版本背景,本站选型使用当前费率和实际请求用量。[2][4]
使用现有 API Key 发起请求。
POST /v1/chat/completionscurl 'https://router-api.xiu.ai/v1/chat/completions' \
-H "Authorization: Bearer $XIUAI_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"model": "claude-sonnet-5",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}'查看完整 API 文档常见问题
为什么设置 temperature 后请求报错?
Sonnet 5 的原生请求不接受 temperature、top_p 和 top_k。移除不支持的采样字段,按当前模型文档使用 effort,并核对兼容协议如何映射参数。[1][4]
Sonnet 5 是否等于较便宜的 Opus?
不是。它是独立型号;发布时的对比基于具体任务与 effort 条件。应分别核对能力、参数和实际成本,不能把一个模型的全部限制或工具行为继承给另一个。[2][1]
切到 5.5 后强制工具调用为什么可能失败?
5.5 的迁移指南明确列出 forced tool choice 为需要改动的设置。先检查原应用是否依赖 any 或指定 tool,再按目标型号支持的规则设计工具选择与参数校验。[3]
相关模型
claude-sonnet-5-5claude-opus-5-5资料来源与更新
规格参考供应商文档;价格与可用性来自当前 XiuAI 目录。
内容复审:2026-11-16
[1] Claude Sonnet 5 官方模型文档[2] Claude Sonnet 5 发布说明[3] Anthropic 版本迁移指南[4] XiuAI 当前模型与价格数据模型文档工具调用结构化输出上下文说明