如果你准备接入 Anthropic API,查 Claude 模型不能只看网页端选项或旧教程里的清单。截至 2026 年 10 月 9 日,Anthropic 官方模型概览列出的当前型号包括 Claude Fable 5.1、Opus 5.5、Sonnet 5.5 和 Haiku 5.5,对应 API 模型 ID 分别是 claude-fable-5-1、claude-opus-5-5、claude-sonnet-5-5 和 claude-haiku-5-5。但目录会更新,具体账号及调用平台能否使用某个型号,仍应以当前模型目录、账号权限和所用平台的文档为准。
Claude API 有哪些模型?
Anthropic 官方模型概览在核查日期列出以下四个当前型号。表中的 ID 是 Claude API 使用的标识,不是单纯的系列名称:
| 官方展示名称 | Claude API 模型 ID | 官方概览中的用途描述 |
|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 | 面向高要求推理和长周期智能体任务 |
| Claude Opus 5.5 | claude-opus-5-5 | 面向长时间运行的智能体编程与知识工作 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | 兼顾速度与智能表现 |
| Claude Haiku 5.5 | claude-haiku-5-5 | 面向分类、信息提取、路由等高调用量、低延迟任务 |
这张表适合快速认识当前主力型号,但不等于 API 中所有历史型号的完整清单。官方模型概览会介绍当前阵容;Models API 则能返回模型目录及生命周期信息,其中可能包含已弃用型号。不要将不同版本文章、界面展示名和 API 请求所需 ID 混为一谈。官方概览还说明,模型能力与可用平台可能各不相同;如果你的工作流依赖某项具体能力,应查对应型号的说明,而不是只凭系列名判断。
怎样查询当前的 Claude API 模型列表?
Anthropic 提供 Models API,地址为 GET https://api.anthropic.com/v1/models。官方说明该接口用于列出可用于 API 的模型,并返回模型 ID、展示名称、生命周期及其他信息。直接 API 调用需要 API Key 和必需的 anthropic-version 请求头。可以用下面的命令查询活动型号:
curl "https://api.anthropic.com/v1/models?lifecycle=active&limit=100" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
先在环境变量 ANTHROPIC_API_KEY 中配置自己的密钥,不要把真实密钥写进公开代码、日志或文章。接口支持用 lifecycle 筛选状态:active 表示当前可用且对新使用者开放;deprecated 表示已有权限的组织仍可能调用,但型号已不向新使用者开放并将走向退役;retired 表示不能再用于推理。省略生命周期筛选时,目录包含活动和已弃用型号;要查询已退役的历史记录,需明确请求该状态。
目录可能分多页返回。响应中的 has_more 表示是否还有后续结果,last_id 可作为后续请求的 after_id 游标。列表较长时不要只读取第一页就认定拿到了完整目录。使用多工作区凭据时,还要按需选择匹配的工作区;官方文档说明,只有可访问多个工作区的凭据才需要通过 anthropic-workspace-id 指定工作区。
目录里有型号,为什么调用仍可能失败?
首先看接口返回的生命周期,而不是只看型号是否出现在目录里。已弃用型号可能仍对已有访问权限的组织开放,却不代表新账号可以启用;已退役型号则不能用于推理。若请求报错,逐项核对实际请求中的 model 值、所用凭据对应的工作区,以及该型号是否处于活动状态。
其次,确认自己调用的是哪一个平台。Anthropic 官方 Claude API 与 Amazon Bedrock、Google Cloud 等平台的认证方式和模型标识并不总是相同。Anthropic 官方模型概览列出的 Bedrock ID 带有 anthropic. 前缀,例如当前概览中的 anthropic.claude-sonnet-5-5;不能因此推断任意 API 网关都接受这一格式。若通过云平台调用,应查询该平台的目录、开通要求和请求文档,不要直接复制 Anthropic API 的 ID 或请求方式。
还要注意版本标识的含义。Anthropic 的模型 ID 文档说明,模型 ID 用于指向具体版本;从 Claude 4.6 一代开始,ID 不带日期并不表示它会自动切换到最新权重,更新版本会使用新的 ID。较早一代模型可能采用带日期的快照 ID,在 Claude API 中也可能提供便捷别名。若项目要求结果可复核,应记录实际使用的完整 ID,而不是自行猜测别名的指向。
确定型号后,怎样做调用前检查?
- 确定调用平台。先分清是直接调用 Anthropic API,还是通过 Bedrock、Google Cloud 等云服务;后者要查对应平台的模型目录与认证要求。
- 查询当前目录。使用官方模型概览快速查看当前阵容;需要核对账号当前可用状态时,使用 Models API 并查看生命周期字段。
- 复制完整 ID。将官方返回的 API ID 填入请求的
model字段,避免把展示名称、旧版别名或其他平台的标识当成通用 ID。 - 核对权限和参数。确认密钥对应的工作区和型号访问状态,并参考该型号与所用平台的接口说明核对请求参数。仅凭目录条目不能推出所有参数或工具功能都可用。
- 保存核查记录。在项目配置或部署记录中写明查询日期、调用平台和完整模型 ID。型号目录、生命周期和平台支持范围可能变化,正式部署或迁移前重新核对。
确认一个型号存在,只解决了“能否找到它”的问题,并不能说明它一定最适合你的任务。Anthropic 官方模型概览提供型号用途、能力与定价等信息,但模型列表本身不是性能排名。若要选型,先明确任务要求,再查对应模型的官方说明和当前价格;不要凭型号名称、旧截图或未经核实的对比数字作决定。
本文中的型号列表、接口字段和生命周期说明按 Anthropic 官方文档于 2026 年 10 月 9 日核查。文档及可用型号可能更新,涉及实际部署时请以届时的官方模型目录和平台说明为准。
相关问题
Models API 返回多页时,怎样继续查询?
检查响应中的 has_more;若仍有后续结果,使用 last_id 作为下一页请求的 after_id。不要只检查第一页就将其当作完整目录。
Claude API 的模型 ID 能直接用于 Amazon Bedrock 吗?
不要默认可以直接照搬。Bedrock 的型号标识格式与直接调用 Claude API 可能不同,应按 Bedrock 当前模型目录和请求文档确认。
