根据以下地点,安排一个轻松的周六行程:公园开放时间为 9:00-18:00,博物馆为 10:00-17:00,咖啡馆为 8:00-20:00。从 10:00 出发,安排午餐休息,每个地点之间预留 30 分钟。用时间表呈现,不要编造价格或营业时间。
Claude Opus 5.5 API:在线文本生成、使用教程与接入指南
在 RequestBeam 一键接入 Claude Opus 5.5,一个密钥打通 AI 与多种数据服务,让你专注于业务和探索。
Claude Opus 5.5 API 价格与计费
0-1M 输入 Token
官方价格
- 输入
-
$4.0000/M - 输出
-
$20.0000/M - 缓存输入
-
$0.2000/M - 缓存写入(5 分钟)
-
$5.0000/M - 缓存写入(1 小时)
-
$8.0000/M
我们的价格 降低 45%
- 输入
- $2.2000 /M
- 输出
- $11.0000 /M
- 缓存输入
- $0.1100 /M
- 缓存写入(5 分钟)
- $2.7500 /M
- 缓存写入(1 小时)
- $4.4000 /M
Claude Opus 5.5 在线对话工具
模型设置
开启后,下次请求会附带当前对话中已完成且可复用的轮次,方便连续追问,无需重复背景。
关闭后会怎样?只发送新消息和已设置的系统提示词。已有消息仍会显示;重新开启后,符合条件的历史轮次会再次加入请求。
这是长期记忆吗?不是。这是当前对话的上下文,不会跨独立对话记忆。失败、停止、截断或无法复用的回复不会加入。历史越多,输入 Token 用量和费用可能越高。
高级参数
对话

今天有什么可以帮你?
暂无响应数据 Claude Opus 5.5 提示词示例
根据以下情况,起草一封礼貌的客户邮件:订单将延迟两天到达,新的送达日期为 10 月 15 日,物流信息会在明天发送。表达歉意,但不要自行承诺补偿。包含邮件主题,正文控制在 120 字以内。
把以下会议记录整理成行动清单:玛雅将在周五前修改方案;利奥将在下周一确认场地;预算仍待审批,尚未指定负责人。用表格列出任务、负责人、截止时间和待确认事项,缺失信息标为“未明确”。
什么是 Claude Opus 5.5
面向复杂编程与知识工作的 Claude 系列模型
我们将 Claude Opus 5.5 定位为面向复杂编程、资料分析和多步骤工作的通用模型。Anthropic 于 2026 年 9 月 22 日发布这一版本,重点强调长时间编程任务与专业知识工作的表现。
对于实际使用,我们更看重它能否理解已有项目和业务约束,在处理过程中持续利用新信息,并把结果推进到可以验收的程度。例如,根据需求修改多个模块、结合资料准备分析报告,或在工具返回结果后继续完成后续步骤。
支持百万 Token 上下文与图像输入的多模态模型
Claude Opus 5.5 的官方 API 提供 1M Token 上下文,标准最大输出为 128K Token,支持文本和图像输入,输出为文本。官方模型规格
我们认为,这种配置适合把需求文档、代码、日志和界面截图放在同一任务中分析。为了让结果更容易核对,我们建议为资料/文件名进行编号,并要求结论对应具体证据;输入内容较多时,仍应明确本次需要解决的问题。
通过自适应思考分配推理投入的模型
Claude Opus 5.5 始终启用自适应思考,可以通过 effort 调节推理投入,支持 low、medium、high、xhigh 和 max 五档,官方默认值为 medium。这一参数会影响模型处理任务的方式和 Token 消耗,但不是精确的思考 Token 配额。官方 Effort 文档
我们建议从 medium 开始建立业务测试场景,再根据模型的反馈进行调整:简单提取和格式整理可以评估 low;涉及多个约束的代码分析可以对照 high;对于确实需要反复验证的难题,再判断 xhigh 或 max 增加的投入是否值得。
RequestBeam 的 Claude Opus 5.5 在线工具与 API
我们希望通过 RequestBeam,让你更快地了解 Claude Opus 5.5 在自己任务中的真实表现。你只需要登录、创建 API Key,并完成少量充值,就可以通过在线工具开始体验,无需先编写 API 对接代码,也不必为了短期评估购买固定套餐,同时减少自行管理多个模型平台账号的麻烦。
Claude Opus 5.5 的核心功能与领域优势
项目编程:同时关注功能实现与架构质量
我们认为,Claude Opus 5.5 值得用于现有项目的修复、重构和代码审查,尤其是需要理解模块职责与既有约定的工作。在客户的反馈中,某些客户让它审阅其他模型生成的代码,模型指出了可以简化的实现,以及与项目架构分层不一致的问题;作者认为这些意见与自己阅读修改内容时的判断一致。而另一位客户则表示,Opus 5.5 曾引用不存在的代码行号,重新核对后才修正部分结论。
因此,我们建议要求每条审查意见附上实际代码、触发条件和影响范围,再决定是否修改,还有就是控制上下文的长度。
工具协作:持续推进有明确验收标准的长任务
我们更看重模型在读取文件、修改代码、运行测试和检查结果之间持续推进的能力。Cursor 的官方使用说明将长任务中的子 Agent 协调列为 Opus 5.5 的优势,这类能力需要配合应用提供的工具和执行环境使用。Cursor 的模型说明
在客户的反馈中,客户和我们分享了使用 Opus 5.5 重做旧桌面应用表格控件的经历:只通过已有 API 行为和截图对比定义目标,让模型生成实现、测试与图像差异报告,最终完成了需求。
我们从这些案例中更观察到,在实际接入时,我们建议把长任务拆成可以检查的阶段,为每一阶段提供足够的上下文输入、预期产物和通过条件,让模型根据执行反馈继续工作。
办公分析:处理表格细节,并检查结果之间的关系
我们认为,Claude Opus 5.5 的办公价值在于它可以整理表格、追踪公式依赖、制作图表,以及根据材料准备说明。在 GPT for Work 于 2026 年 10 月 6 日公布的 AutosheetBench 中,Opus 5.5 的 medium 配置通过了 187 项 Excel 小任务中的 94.7%。这是一套在 GPT for Excel 工具环境中运行的测试,覆盖独立操作。AutosheetBench 原始实测
其中,模型能够正确处理现金流瀑布图的期末合计,也能按类别建立可分别折叠的行分组;但在公式依赖追踪中,它仍出现过找出相关单元格后写错引用地址的情况。我们因此建议同时检查计算逻辑、引用位置和最终展示,尤其不要把小任务成绩直接外推到完整财务模型或整份业务报告。具体成功与失败案例
可视化开发:用代码构建界面与产品演示
我们会把 Claude Opus 5.5 的多模态能力理解为图像理解、代码生成与工具编排的结合。客户和我们分享了他为他的产品制作视频的过程:提供文章的 Markdown 内容,让模型生成 HTML 和 JavaScript 动画,再通过 ffmpeg 输出视频,客户表示他对首轮结果表示满意,并表示节省了自己的很多时间,而且自己确实无法达到Opus 5.5的制作效果。
我们认为,这类工作方式适合产品功能演示、交互原型和可继续修改的教学动画。比如,对于独立开发者来说,会帮助他们更好地去宣发自己的作品。
文字表达:更清楚地解释问题并适应指定文风
我们在关注文字能力的同时,也会看表达是否容易理解,以及内容是否适合目标读者。在客户的反馈中,有些用户表示 Opus 5.5 的写作与细节处理有所改善,但有时对于内容过于挑剔;另外一些用户则认为输出比 Opus 5 更容易阅读,但输出的文字中仍然有些啰嗦。
我们将这些反馈作为值得试用的线索。对于产品说明、帮助文档和研究摘要,我们建议同时提供受众、篇幅、语气与参考样例,这样的输出可能会效果更好。
Claude Opus 5.5 基准测试与性能表现
我们在下面保留评测版本、思考档位和运行设置,我们也会区分发布时的官方测试与后来更新的数据。
终端任务:Terminal-Bench 4.0 官方 66.4%,独立评测 59.6%
- Anthropic 官方 · xhigh 标准误:±2.6 个百分点 66.4%
- Artificial Analysis 独立评测 · max 默认后备配置(Default Fallback) 59.6%
- Artificial Analysis 独立评测 · xhigh 默认后备配置(Default Fallback) 59.6%
AA 使用 mini-swe-agent,66 项任务各重复三次。
Anthropic 发布的 Terminal-Bench 4.0 成绩中,Opus 5.5 在 xhigh 档位得到 66.4%,标准误为 ±2.6 个百分点。Artificial Analysis 的独立测试则使用 mini-swe-agent,在 66 项任务上各重复三次,Opus 5.5 的 max 与 xhigh 默认后备配置均为 59.6%。Anthropic 官方结果 · Artificial Analysis 独立结果
项目编程:CursorBench 4.0 在 High 档达到 56.0%
- Medium 52.5%
- High 56.0%
- Max 57.8%
High 到 Max 增加 1.8 个百分点,平均任务成本从 3.97 美元升至 13.43 美元。
- Medium $2.91
- High $3.97
- Max $13.43
成本按对应模型的公开 Token 单价与实际用量计算。
CursorBench 4.0 使用来自真实 Cursor 会话的多文件任务,包含需求理解、修改与重构等工作。主办方公布的 Opus 5.5 数据如下,成本按对应模型的公开 Token 单价与实际用量计算。CursorBench 4.0 原始榜单
| 思考档位 | 成绩 | 平均每任务成本 |
|---|---|---|
| Medium | 52.5% | 2.91 美元 |
| High | 56.0% | 3.97 美元 |
| Max | 57.8% | 13.43 美元 |
我们更关注 high 到 max 的变化:成绩增加 1.8 个百分点,平均任务成本明显提高。基于这组结果,我们建议先比较 medium 与 high,只有当额外完成的任务能够覆盖新增成本时,再扩大 max 的使用范围。根据我们在其他同类模型的评测结果中的经验来看,high 这一档基本可以满足大部分的日常需求,当然,我们仍然建议客户在接入之前先找一个小场景进行测试。
知识工作:GDPval-AA v2.1 达到 1866 Elo
- 相对评分
- 1866 Elo
- Max · 默认后备配置(Default Fallback)
置信区间:±26。覆盖 44 个职业和 9 类行业,通过匿名成对比较评分。
在 Artificial Analysis 当前的 GDPval-AA v2.1 榜单中,Opus 5.5 的 max 默认后备配置为 1866 Elo,置信区间显示为 ±26。评测覆盖 44 个职业和 9 类行业,要求模型利用工具提交文档、表格和演示等实际产物,再通过匿名成对比较形成评分。GDPval-AA v2.1 榜单与方法
我们认为,这比只看短问答更接近专业工作的使用场景。评估报告准备或办公助手时,我们建议检查输出是否完整、数据是否有依据,以及读者能否直接理解和使用,如果你希望文字流畅而优美,那么可能需要自己介入来优化。
跨应用自动化:AutomationBench 完成率为 42.47%
- 任务完成率
- 42.47%
- Max · 默认后备配置(Default Fallback)
- 平均任务成本
- 1.44 美元/任务
在模拟环境中按最终状态评分。
Zapier 的 AutomationBench v1.0.6 显示,Opus 5.5 在 max、默认后备配置下的成绩为 42.47%,平均每任务成本为 1.44 美元。评测在包含客户记录、邮件和日历等信息的模拟环境中运行,依据最终状态是否满足要求评分。Zapier AutomationBench
我们的理解是:42.47% 说明,Opus5.5 模型具备了较强的工具使用能力,但如果流程过于复杂,那么它的输出结果可能并没有你想象的这么好
独立指数与生成速度:综合得分 58,输出约 97 Token/秒
- Intelligence Index v4.3.2
- 58 分
- Max · 默认后备配置(Default Fallback)
- Anthropic API 输出速度
- 约 96.8 Token/秒
Artificial Analysis 的 Intelligence Index v4.3.2 将 Opus 5.5 的 max 默认后备配置记为 58 分;对 Anthropic API 的测量显示,输出速度约为每秒 96.8 Token。Artificial Analysis 模型评测
以我们的经验来看,如果你对响应速度有要求,那么 Opus 5.5 可能不是你最好的选择;但是如果你追求输出质量,那么我们觉得你应该优先考虑 Opus 5.5。或者可以把思考档位调低一些,但具体要看业务是否能够接受调低档位以后输出的结果。
Claude Opus 5.5 与 Opus 5、Fable 5.1、GPT-6 Astra、Sonnet 5.5 同类模型对比
- Claude Opus 5.5 Max · 默认后备配置(Default Fallback) 58
- Claude Opus 5 Max 51
- Claude Fable 5.1 Max · 默认后备配置(Default Fallback) 53
- GPT-6 Astra Max 53
- Claude Sonnet 5.5 Max · 默认后备配置(Default Fallback) 56
- Claude Opus 5.5 Max · 默认后备配置(Default Fallback) $5.98
- Claude Opus 5 Max $5.86
- Claude Fable 5.1 Max · 默认后备配置(Default Fallback) $7.63
- GPT-6 Astra Max $3.26
- Claude Sonnet 5.5 Max · 默认后备配置(Default Fallback) $7.67
对比 Claude Opus 5:能力提高,任务费用仍取决于推理档位
在 Artificial Analysis 的对比中,Opus 5.5 使用 Max、默认后备配置,Opus 5 使用 Max 配置。两者的综合指数分别为 58 和 51,AA-LCR v1.1 长文成绩按页面取整后分别为 85% 和 79%。但同一指数的加权每任务成本分别为 5.98 美元和 5.86 美元;虽然新版本的 Token 单价降低,Max 配置下的任务消耗并没有同步下降。Opus 5.5 与 Opus 5 对比
从测试对比的成本来看,我们建议我们的用户可以从 opus5 升级到 opus5.5。
对比 Claude Fable 5.1:综合成绩与任务成本更有吸引力
在同为 Max、默认后备配置的独立对比中,Opus 5.5 与 Fable 5.1 的综合指数分别为 58 和 53,加权每任务成本分别为 5.98 美元和 7.63 美元;AA-LCR v1.1 的页面取整成绩均为 85%。我们据此认为,Opus 5.5 在这组综合测试中更值得优先评估,长文这一项则表现接近。Opus 5.5 与 Fable 5.1 对比
对于已经使用 Fable 5.1 的团队,我们建议先看业务场景,再决定是否切换:Fable 5.1 更适合规划型的工作,Opus 5.5 更倾向于执行层面。
对比 GPT-6 Astra:综合分更高,Max 配置的任务成本也更高
在 Artificial Analysis 的对比中,Opus 5.5 使用 Max、默认后备配置,GPT-6 Astra 使用 Max 配置。两者的综合指数分别为 58 和 53,但加权每任务成本分别为 5.98 美元和 3.26 美元。对应的每任务输出 Token 约为 11.9 万和 2.7 万,包含推理消耗。Opus 5.5 的较低 Token 单价,在这套高档位测试中并未转化为更低的任务费用。Opus 5.5 与 GPT-6 Astra 对比
我们建议如果用户的基建能够满足Astra和Opus混用的场景,那么在工程执行层面推荐使用 GPT-6 Astra High,而在规划层面,可以尝试使用 Opus5.5。
对比 Claude Sonnet 5.5:按工作类型选型,不能只按产品档位排序
在 Artificial Analysis 的 Max 默认后备配置中,Opus 5.5 与 Sonnet 5.5 的综合指数分别为 58 和 56。但在前面提到的 Zapier AutomationBench 中,Sonnet 5.5 的成绩为 44.75%,高于 Opus 5.5 的 42.47%;对应每任务成本也更低,为 1.14 美元和 1.44 美元。独立综合对比 · Zapier 自动化对比
另一方面,在 AA 综合指数的 Max 配置中,Sonnet 5.5 的加权每任务成本为 7.67 美元,高于 Opus 5.5 的 5.98 美元。我们认为,这说明低单价型号同样需要控制推理投入。任务成本对比
我们建议,如果用户对于输出响应有比较高的要求,那么可以考虑使用 Sonnet 5.5,但是具体要根据业务场景来做测试。
Claude Opus 5.5 API 常见问题
如何通过 RequestBeam 调用 Claude Opus 5.5 API?
我们建议先登录 RequestBeam,创建 API Key,然后查看我们的文档或者让AI帮助你配置连接。
我们建议先通过在线工具完成一次最小生成测试,再根据 RequestBeam 当前的 Claude Opus 5.5 API 文档对接。这样可以先验证模型是否满足业务需求,也能避免把其他服务商的接口路径和参数错误地带入 RequestBeam。
为什么从旧模型迁移后,关闭思考或设置采样参数会报错?
我们建议先检查旧请求中的 thinking、temperature、top_p 和 top_k。按照 Anthropic 官方迁移文档,Opus 5.5 不接受 thinking: {"type":"disabled"},也不接受旧式 enabled 配合 budget_tokens 的手动思考设置;非默认采样参数同样可能使请求返回 400,迁移时宜将这些采样字段移除。Anthropic 迁移指南
需要调节推理投入时,官方接口使用 output_config.effort,默认是 medium。我们建议明确设置需要的档位,再比较实际质量和用量。通过 RequestBeam 的兼容入口使用模型专有字段时,还应检查对应入口与所选服务的支持情况,通用参数表并不意味着所有型号都接受相同设置。Effort 参数说明 · RequestBeam 参数说明
为什么请求成功却没有正文,输出 Token 仍然增加?
使用 Claude Messages 接口时,我们建议先检查 stop_reason 和输出预算。它的 max_tokens 同时覆盖思考与最终正文,设置得过小,可能在正式回答之前就因预算耗尽而结束。RequestBeam 的模型目录特别提醒,128 这样的预算可能只产生思考内容。RequestBeam 输出预算说明
其次,我们建议按内容块的 type 提取 text,不要固定读取 content[0].text。按照 Anthropic 官方文档,Opus 5.5 默认省略思考文本,但仍保留签名,思考 Token 也仍计入输出用量。遇到 stop_reason: "max_tokens" 时,可以增加预算,或在质量允许时降低 effort;连续工具调用还需要完整保留返回的内容块与签名。官方思考与用量说明 · 思考预算调整 · RequestBeam 内容块说明
为什么不能强制调用工具,结构化 JSON 应该怎样配置?
我们建议根据目的选择配置。在 Anthropic 官方 API 中,Opus 5.5 的 tool_choice 支持 auto 和 none,强制指定 any 或某个 tool 会返回 400。需要模型使用工具时,应提供清楚的工具定义和适用条件,并让应用处理工具调用与结果回传。官方工具调用规则
如果需要约束最终回答的 JSON 结构,官方接口使用 output_config.format;如果需要约束工具参数,则使用工具定义中的 strict: true。严格参数约束不会强制模型调用工具,拒绝或输出截断等情况也仍需处理。官方结构化输出文档
为什么通过 RequestBeam 使用 Claude Opus 5.5?
按需计费与模型成本优化
在稳定的基础上,价格比官方更低,按需充值,充多少用多少
统一 AI模型 与数据 API,一站式多模型接入
一个密钥多个AI模型和数据模型,节省对接成本,一键切换,业务需要的场景必然是AI+数据
调用记录与应用权限控制,每一次调用明明白白
每一笔调用记录都可以在后台查到,可以设置多个密钥对应不同的应用
模型能力不打折
我们的模型不掺水,我们无法卖给你最便宜的,但一定卖给你最好的
如何在 RequestBeam 中使用 Claude Opus 5.5
在后台创建完密钥后,就可以根据文档来接入 Claude Opus 5.5。
准备账户并进行在线测试
登录并确认余额,创建一个 API 密钥。
在 Playground 中体验
可以在 Playground 中体验模型的能力,确定最佳的模型使用方案。
将 Claude Opus 5.5 集成到你的业务中
根据我们提供的开发文档,将 Claude Opus 5.5 集成到业务中。
后续的模型升级
后续有新的模型发布以后,只需要将模型名称替换成新模型,就可以完成模型升级。
Claude Opus 5.5 在线工具与 API 接入答疑
Claude Opus 5.5 与 Opus 5 是同一个 API 模型吗?
不是。Claude Opus 5.5 的接口模型名称是 claude-opus-5-5,Claude Opus 5 的接口模型名称是 claude-opus-5。它们是不同模型,调用时请勿混用 model 参数。
为什么 thinking 为空,或者回答不完整?
原生 Opus 5.5 默认启用自适应思考,可以省略思考文本;普通调用无需填写 thinking 参数,空 thinking 不代表失败。 如果回答不完整,请检查结束状态及输出额度,为思考和最终正文留出足够空间。
可以通过 OpenAI Responses 调用 Claude Opus 5.5 吗?
不支持 OpenAI Responses。Claude 有自己的 Claude Messages 格式,详情参考文档。
可以强制调用工具或编辑原生 Messages 会话吗?
原生 Opus 5.5 不支持 tool_choice 的 any 或 tool 强制模式。 修改早期会话内容后重放保留的思考块也需谨慎。工具续轮应完整保留原生 assistant 内容块及其中的签名。
对话记忆是长期记忆吗?
不是。API 不会自动为后续请求保留对话上下文;你需要自行管理会话历史,并在请求中传入所需内容。长期记忆需要由应用实现。
相关文本 API
Claude Opus 5.5 API 接口规范与调用
Claude Opus 5.5 API 快速调用
claude-opus-5-5Chat CompletionsPOST /v1/chat-completions
curl -X POST "https://api.requestbeam.com/v1/chat-completions" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"Hello, introduce yourself in one sentence."}],"stream":false}'MessagesPOST /anthropic/v1/messages
Messages 必须填写 max_tokens。示例额度可调整,不是上游默认值或模型上限。思考可能在生成正文前耗尽该额度;请按任务调整并检查输出费用。
curl -X POST "https://api.requestbeam.com/anthropic/v1/messages" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-H 'anthropic-version: 2023-06-01' \
-d '{"model":"claude-opus-5-5","max_tokens":4096,"messages":[{"role":"user","content":"Hello, introduce yourself in one sentence."}],"stream":false}'家族与协议参考
Claude Messages
完整 API 文档Claude 原生 Messages 兼容接口。该接口使用 Anthropic Messages 请求和响应格式,适合 Claude Code、工具调用、流式输出和需要 Anthropic 原生事件格式的应用。
https://api.requestbeam.com/anthropic/v1/messagesClaude 原生 Messages 兼容接口。该接口使用 Anthropic Messages 请求和响应格式,适合 Claude Code、工具调用、流式输出和需要 Anthropic 原生事件格式的应用。
POST https://api.requestbeam.com/anthropic/v1/messages验证
所有接口都需要使用 RequestBeam API Key 认证。Anthropic SDK、Claude Code 和兼容客户端通常使用 x-api-key;普通 HTTP 客户端也可以使用 Bearer Token。
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01Body
modelstring必填默认: claude-sonnet-4-6支持的 Claude 模型 ID。
claude-fable-5claude-fable-5-1claude-haiku-4-5claude-opus-4-5claude-opus-4-6claude-opus-4-7claude-opus-4-8claude-opus-5claude-opus-5-5claude-sonnet-4-5claude-sonnet-4-6claude-sonnet-5
当前 API Key 的实际可用范围以 GET https://api.requestbeam.com/v1/models 返回结果为准。
max_tokensinteger必填最大输出 token 数量,必须是正安全整数。该预算包含 thinking 和最终正文的输出 token。 缺失、零、负数、小数、字符串或非安全整数会在生成和计费前返回 HTTP 400, 错误类型为 invalid_request_error。模型可能有更低的上限。
对包含 thinking 的模型,128 等较小预算可能只产生 thinking 内容块,随后以 stop_reason: "max_tokens" 结束,没有文本正文。请按任务和所选模型显式设置预算, 为思考和最终正文留出空间。示例数值是可调整的额度,不是上游默认值或模型上限; 较大额度可能增加输出用量和费用。
messagesobject[]必填对话消息数组。每条消息包含 role 和 content。
role 支持 user 和 assistant。content 可以是字符串,也可以是内容块数组。
systemstring | object[]系统指令。Anthropic Messages 使用独立的 system 字段,不使用 messages 里的 system role。
streamboolean默认: false是否返回 Anthropic SSE 事件。
temperaturenumber采样温度。可接受范围及实际效果因所选模型而异。
top_pnumber核采样参数。请求被接受不代表该参数一定改变生成行为。
top_kintegertop-k 采样参数,支持情况由所选模型决定。
stop_sequencesstring[]停止序列。
携带非空停止序列的请求不会交给已知不支持该参数的模型服务;若没有可用的兼容服务,则在生成和计费前返回 400。
toolsobject[]Anthropic 工具定义。函数工具通常使用 name、description 和 input_schema。
tool_choiceobject工具选择策略,例如 { "type": "auto" } 或 { "type": "tool", "name": "..." }。
thinkingobject原生 Anthropic thinking 配置,实际支持取决于所选模型及供应商。 Claude 4.5 使用 { "type": "enabled", "budget_tokens": 1024 };Sonnet/Opus 4.6 也支持 adaptive thinking。不要将手动预算配置套用于所有模型版本。 工具续轮应按原顺序回传完整 assistant 内容,包括 thinking、signature、 redacted_thinking 和 tool_use,不要改写。工具调用及结果回传期间保持 thinking 配置和所需 anthropic-beta 请求头一致。 SSE 中应按同一内容块拼接 signature_delta.signature;thinking 摘要为空也不能丢弃签名。 供应商账户权限拒绝属于上游故障,不能据此判断签名无效。已识别的 Bedrock 账户权限拒绝 返回 HTTP 502 和 api_error;普通客户端参数错误仍为 HTTP 400。实际调用仍需上游账户开通权限。
metadataobject请求元数据。
Prompt Cache
可以在 system 或消息内容块中加入 cache_control: { "type": "ephemeral" }。命中缓存时,usage 会返回 cache_creation_input_tokens、cache_read_input_tokens,以及支持的 5 分钟 / 1 小时 cache creation 明细。1 小时 TTL 还需要对应的 anthropic-beta header。
请求体示例
非流式
{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "你好,请用一句话介绍你自己。"
}
],
"stream": false
}流式
{
"model": "claude-haiku-4-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "Reply exactly OK."
}
],
"stream": true
}Response
非流式响应保持 Anthropic Message 结构。
idstring响应 ID,例如 msg_...。
typestring对象类型,通常为 message。
rolestring通常为 assistant。
modelstring实际使用的 Claude 模型。
contentobject[]输出内容块数组,可能包含 text、tool_use 和 thinking 等原生内容块。
stop_reasonstring停止原因,例如 end_turn、max_tokens、stop_sequence 或 tool_use。
usageobjectToken 使用统计,包含 input_tokens 和 output_tokens。如果响应包含缓存 token 信息,也会在这里返回。
成功响应示例
{
"id": "msg_01...",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-4-6",
"content": [
{
"type": "text",
"text": "你好,我是 Claude,可以帮助你处理写作、代码和分析任务。"
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 18,
"output_tokens": 24
}
}流式响应
stream: true 时返回 Anthropic SSE 事件,常见事件包括:
message_startcontent_block_startcontent_block_deltacontent_block_stoppingmessage_deltamessage_stop
失败响应
完整错误码、协议差异和排查步骤见错误码与错误处理。
错误响应保持 Anthropic 风格:
{
"type": "error",
"error": {
"type": "authentication_error",
"message": "Invalid credentials or API key has expired."
}
}