Claude Opus 4.6

Anthropic 当前最智能的 Claude 模型，面向复杂编程、长周期 Agent 工作流与高难度推理任务。

模型信息

属性	值
模型ID	claude-opus-4-6
任务类型	对话（Chat）/ 推理 / 编程 / Agent
输入	文本 / 图片 / 文档（PDF、纯文本）/ 工具结果
输出	文本 / 思考块 / 工具调用块
标准上下文窗口	200K tokens
扩展上下文窗口	1M tokens（beta，需要 anthropic-beta: context-1m-2025-08-07）
最大输出	128K tokens
视觉理解	支持
扩展思考	支持，推荐 thinking: {"type":"adaptive"}

支持的能力

能力	支持
文本生成	是
图片输入	是
PDF / 文档输入	是
流式输出	是
扩展思考	是
自适应思考	是（官方推荐）
工具调用	是
结构化输出	是
Prompt Caching	是
Batch API	是
数据驻留控制	是（inference_geo）

API 调用

端点

POST https://api.anthropic.com/v1/messages

请求头

参数	类型	必填	说明
Content-Type	string	是	固定为 application/json
X-Api-Key	string	是	Bearer 不需要，直接传入 Anthropic API Key
anthropic-version	string	是	当前文档示例为 2023-06-01
anthropic-beta	string	否	可选 beta 头；如启用 1M 上下文需传 context-1m-2025-08-07

请求参数

参数	类型	必填	默认值	说明
model	string	是	-	模型 ID，填写 claude-opus-4-6
max_tokens	integer	是	-	最大输出 token 数；不同模型允许的最大值不同，Opus 4.6 最高 128K
messages	object[]	是	-	对话消息列表；每项包含 role 与 content
system	string / object[]	否	-	系统提示，可传字符串或文本块数组
stream	boolean	否	false	是否使用 SSE 流式返回
stop_sequences	string[]	否	-	自定义停止序列；命中后 stop_reason 为 stop_sequence
temperature	number	否	1.0	采样温度，范围 0.0-1.0
top_p	number	否	-	nucleus sampling 参数，范围 0-1；一般不要与 temperature 同时调大
top_k	integer	否	-	仅从前 K 个候选中采样，适合高级控制场景
thinking	object	否	-	扩展思考配置；Opus 4.6 推荐 {"type":"adaptive"}，type:"enabled" + budget_tokens 已弃用
output_config	object	否	-	输出控制项，可设置 effort 与 format（JSON Schema 结构化输出）
tools	object[]	否	-	工具定义列表，支持客户端工具和服务器端工具
tool_choice	object	否	auto	工具策略，可选 auto / any / tool / none
metadata	object	否	-	请求元数据，目前公开字段为 user_id
inference_geo	string	否	工作区默认值	指定推理区域，如 global（默认）或 us
service_tier	string	否	auto	服务层级选择，auto 或 standard_only

请求示例（推荐写法：自适应思考）

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 4096,
    "thinking": {
      "type": "adaptive"
    },
    "output_config": {
      "effort": "high"
    },
    "messages": [
      {
        "role": "user",
        "content": "请设计一个支持重试与幂等性的支付回调处理方案，并给出关键伪代码。"
      }
    ]
  }'

请求示例（1M 上下文 beta）

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: context-1m-2025-08-07" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "请分析这份大型代码库中的架构分层问题。"
      }
    ]
  }'

响应示例

{
  "id": "msg_01ABCxyz",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-4-6",
  "content": [
    {
      "type": "thinking",
      "thinking": "..."
    },
    {
      "type": "text",
      "text": "下面给出一个支持重试与幂等性的支付回调处理方案。"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 128,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 620
  }
}

注意事项

• Opus 4.6 推荐使用自适应思考；thinking: {"type":"enabled","budget_tokens":N} 仍可用，但官方已标记为弃用。
• output_format 旧参数已迁移到 output_config.format；新接入建议直接使用 output_config。
• Opus 4.6 不支持“助手预填充”（即最后一条输入消息为预填充的 assistant 内容）；官方文档说明此类请求会返回 400。
• 请求超过 200K 输入 token 且启用 1M 上下文时，将按长上下文高级费率计费。

计费

按美元 / 百万 token 计费。

项目	价格
输入	$5 / MTok
输出	$25 / MTok
5 分钟缓存写入	$6.25 / MTok
1 小时缓存写入	$10 / MTok
缓存读取	$0.50 / MTok
Batch API 输入	$2.50 / MTok
Batch API 输出	$12.50 / MTok

长上下文定价（1M beta）

输入规模	输入价格	输出价格
<= 200K 输入 token	$5 / MTok	$25 / MTok
> 200K 输入 token	$10 / MTok	$37.50 / MTok

定价补充

• 1M 上下文窗口目前为 beta，仅对 Usage Tier 4 和自定义限流组织开放。
• 若通过 inference_geo: "us" 指定仅限美国推理，Claude Opus 4.6 及更新模型的所有 token 定价类别都会乘以 1.1 倍；若同时使用长上下文费率，该乘数也会叠加生效。
• Prompt Caching 的 5 分钟写入价格为基础输入价的 1.25 倍，1 小时写入为 2 倍，缓存读取为 0.1 倍。

数据来源

• 模型概览：https://platform.claude.com/docs/zh-CN/about-claude/models/overview
• Claude 4.6 新功能：https://platform.claude.com/docs/zh-CN/about-claude/models/whats-new-claude-4-6
• Create a Message：https://platform.claude.com/docs/en/api/messages/create
• 定价：https://platform.claude.com/docs/zh-CN/about-claude/pricing
• 上下文窗口：https://platform.claude.com/docs/zh-CN/build-with-claude/context-windows
• 使用扩展思考进行构建：https://platform.claude.com/docs/zh-CN/build-with-claude/extended-thinking