[ PROMPT_NODE_23874 ]
Shared 模型
[ SKILL_DOCUMENTATION ]
# Claude 模型目录
**仅使用此文件中列出的精确模型 ID。** 切勿猜测或构建模型 ID — 错误的 ID 会导致 API 错误。尽可能使用别名。有关最新信息,请通过 `shared/live-sources.md` 中的模型概览链接进行 WebFetch,或直接查询模型 API(参见下方的“程序化模型发现”)。
## 程序化模型发现
对于**实时**能力数据(上下文窗口、最大输出 token、功能支持(思考、视觉、努力程度、结构化输出等)),请查询模型 API,而不是依赖下方的缓存表。当用户询问“X 的上下文窗口是多少”、“模型 X 是否支持视觉/思考/努力程度”、“哪些模型支持功能 Y”或希望在运行时按能力选择模型时,请使用此方法。
python
m = client.models.retrieve("claude-opus-4-7")
m.id # "claude-opus-4-7"
m.display_name # "Claude Opus 4.7"
m.max_input_tokens # 上下文窗口 (int)
m.max_tokens # 最大输出 token (int)
# capabilities 是一个非类型化的嵌套字典 — 使用括号访问,检查叶子节点的 ["supported"]
caps = m.capabilities
caps["image_input"]["supported"] # 视觉
caps["thinking"]["types"]["adaptive"]["supported"] # 自适应思考
caps["effort"]["max"]["supported"] # 努力程度: max (以及 low/medium/high)
caps["structured_outputs"]["supported"]
caps["context_management"]["compact_20260112"]["supported"]
# 跨所有模型过滤 — 直接迭代页面对象(自动分页);不要使用 .data
[m for m in client.models.list()
if m.capabilities["thinking"]["types"]["adaptive"]["supported"]
and m.max_input_tokens >= 200_000]
顶层字段(`id`, `display_name`, `max_input_tokens`, `max_tokens`)是类型化属性。`capabilities` 是一个字典 — 请使用括号访问,而不是属性访问。API 为每个模型返回完整的完整能力树,每个叶子节点都有 `supported: true/false`,因此括号链在没有 `.get()` 保护的情况下也是安全的。TypeScript SDK:方法名称相同,迭代时也会自动分页。
### 原始 HTTP
bash
curl https://api.anthropic.com/v1/models/claude-opus-4-7
-H "x-api-key: $ANTHROPIC_API_KEY"
-H "anthropic-version: 2023-06-01"
{
"id": "claude-opus-4-7",
"display_name": "Claude Opus 4.7",
"max_input_tokens": 200000,
"max_tokens": 128000,
"capabilities": {
"image_input": {"supported": true},
"structured_outputs": {"supported": true},
"thinking": {"suppo"