跳转到主要内容
本文介绍 Claude Opus 4.7在推理控制方面的两项重要变化，以及 AIHubmix 原生接口与 Chat 统一接口的完整调用说明。详见 Anthropic 官方公告 与 模型更新日志。
Image

​
一、推理控制新特性

​
✦ 新增 xhigh 推理强度级别

全新的 xhigh 等级位于 high 与 max 之间，专为编程与 Agentic 任务设计，在性能与效率之间取得更优平衡。 
low  ──  medium  ──  high  ──  xhigh ★NEW  ──  max

​
✦ 思考内容默认隐藏

流式输出中，思考过程默认不再展示。如需返回思考摘要，须在请求中显式传入 display 字段：
display 值Opus 4.7Opus 4.6效果
”omitted”默认非默认思考块内容为空
”summarized”需手动设置默认返回思考摘要文字
"reasoning": {
  "effort": "xhigh",
  "display": "summarized"
}
图：Opus 4.7 新增 xhigh 级别 — Agentic 编程性能对比（来源：Anthropic 官方）
Image

​
二、Claude 原始格式接口说明

​
Anthropic 原生接口的 effort 值与官方保持一致，参考如下：

effort值适用模型说明推荐场景
low所有支持模型显著节省 token，适当降低能力简单任务、高并发请求、子 agent
medium所有支持模型均衡模式，适度节省 token一般 agentic 任务
high所有支持模型默认值，高能力表现复杂推理、编程、agentic 任务
xhigh（新增）Opus 4.7 专属扩展能力，介于 high 和 max 之间，长程任务表现优异编程和 agentic 任务的推荐起点
maxOpus 系列最高能力前沿研究问题

​
AIHubmix Claude 原生接口 Claude Opus 4.7 调用示例

from anthropic import Anthropic

client = Anthropic(
    api_key="<AIHUBMIX_API_KEY>",
    base_url="https://aihubmix.com"
)

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "xhigh"},  # 可选：low / medium / high / xhigh / max
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ]
)

print(response.content[-1].text)

​
三、AIHubmix Chat 统一接口的推理思考 effort 增加适配

AIHubMix Chat 统一接口与 OpenAI 规范对齐，通过 reasoning.effort 控制推理强度，不同模型自动适配对应级别：

​
Claude 系列模型的参数reasoning_effort （思考强度控制）说明

effort值Opus >=4-7（新增）Opus 4.6 / 4.5Sonnet 4.6
minimallowlowlow
mediummediummediummedium
highhighhighhigh
xhighxhighmaxhigh
maxmaxmaxhigh
说明 ：xhigh 仅 Opus 4.7 原生支持，其他 Opus 模型自动回退到 max，Sonnet 系列回退到 high。

​
Chat 统一接口Opus 4.7 调用示例

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    # max_tokens=10000,  # 默认 4096，生成长文本时启用
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh"}
    }
)

print(completion.choices[0].message.content)

​
四、Chat 统一接口Opus 4.7 控制思考内容说明

在 OpenAI 兼容接口中，reasoning 支持 display 字段，用于控制是否返回思考摘要。 Claude Opus 4.7 默认不返回思考内容，需手动设置 "display": "summarized" 开启。
字段值说明
display(不传)默认不返回思考内容
display"summarized"返回思考摘要

​
Opus 4.7 返回思考摘要示例

from openai import OpenAI

client = OpenAI(
    base_url="https://aihubmix.com/v1",
    api_key="<AIHUBMIX_API_KEY>",
)

completion = client.chat.completions.create(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": "A snail is at the bottom of a 10-meter well. Each day it climbs 3 meters, but each night it slides back 2 meters. How many days does it take to reach the top?"
        }
    ],
    extra_body={
        "reasoning": {"effort": "xhigh", "display": "summarized"}
    }
)

print(completion.choices[0].message.content)
如需进一步了解接口细节，请参考 AIHubmix 官方文档 或 Anthropic 官方文档。