本文涵蓋了 Claude Opus 4.7 中推理控制的兩個關鍵變更，以及 AIHubmix 原生 API 和 Chat 統一介面的完整使用說明。另請參閱：Anthropic 官方公告 和 模型變更日誌。
1. 新的推理控制功能
✦ 新的 xhigh 推理努力級別
新的 xhigh 級別位於 high 和 max 之間，專為 編碼和代理任務 設計，實現能力與效率之間的更好平衡。
low ── medium ── high ── xhigh ★NEW ── max
✦ 默認隱藏思考內容
在串流響應中，思考過程不再默認顯示。要接收推理摘要，請在請求中明確傳遞 display 欄位：
| 顯示值 | Opus 4.7 | Opus 4.6 | 行為 |
|---|---|---|---|
| ”省略” | 默認 | 非默認 | 思考區塊內容為空 |
| ”摘要” | 必須手動設置 | 默認 | 返回思考摘要文本 |
"reasoning": {
"effort": "xhigh",
"display": "summarized"
}
圖：Opus 4.7 新的 xhigh 級別 — 代理編碼性能比較（來源：Anthropic 官方）
2. Claude 原生 API 參考
Anthropic 原生 API 的 effort 值與官方規範一致：
| 努力值 | 支持的模型 | 描述 | 推薦使用案例 |
|---|---|---|---|
| low | 所有支持的模型 | 顯著的代幣節省，能力適度折衷 | 簡單任務，高併發請求，子代理 |
| medium | 所有支持的模型 | 平衡模式，適度的代幣節省 | 一般代理任務 |
| high | 所有支持的模型 | 默認；高能力性能 | 複雜推理、編碼、代理任務 |
| xhigh (新) | 僅限 Opus 4.7 | 在 high 和 max 之間擴展的能力；在長期任務中表現優異 | 編碼和代理任務的推薦起始點 |
| max | Opus 系列 | 最大能力 | 前沿研究問題 |
AIHubmix Claude 原生 API — 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": "一隻蝸牛在一口10米深的井底。每天它爬升3米，但每晚又滑回2米。它需要多少天才能到達井口？"
}
]
)
print(response.content[-1].text)
3. AIHubmix Chat 統一介面的推理努力支持
AIHubMix Chat 統一介面與 OpenAI 規範一致，通過 reasoning.effort 控制推理強度。不同的 Claude 模型會自動映射到相應的努力級別：
reasoning_effort （Claude 模型的推理強度控制）
| 努力值 | Opus >=4.7（新） | Opus 4.6 / 4.5 | Sonnet 4.6 |
|---|---|---|---|
| minimal | low | low | low |
| medium | medium | medium | medium |
| high | high | high | high |
| xhigh | xhigh | max | high |
| max | max | max | high |
注意：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": "一隻蝸牛在一口10米深的井底。每天它爬升3米，但每晚又滑回2米。它需要多少天才能到達井口？"
}
],
extra_body={
"reasoning": {"effort": "xhigh"}
}
)
print(completion.choices[0].message.content)
4. 控制 Chat 統一介面的思考內容
在與 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": "一隻蝸牛在一口10米深的井底。每天它爬升3米，但每晚又滑回2米。它需要多少天才能到達井口？"
}
],
extra_body={
"reasoning": {"effort": "xhigh", "display": "summarized"}
}
)
print(completion.choices[0].message.content)
如需進一步詳細資訊，請參閱 AIHubmix 文檔 或 Anthropic 官方文檔。
最後更新：2026-06-01