跳到文章正文
Claude 实用教程

Claude API怎么查可用模型?生命周期、能力字段与分页检查

读取Models API建立项目模型清单,区分active、deprecated和retired…

Claude API怎么查可用模型?生命周期、能力字段与分页检查

把模型名写死在程序里,容易在迁移或退役时出问题。Claude Models API可以列出模型及生命周期、能力和上下文信息,适合为项目建立可核对的目录。本教程先读取目录,再做条件检查,不把目录里出现名字解释成所有产品入口都开放。

第一步:确认查的是API项目目录

使用自己的Claude API项目与有效鉴权,从官方GET /v1/models读取。本文按当前文档API版本2026-10-21核对字段,旧版本或旧SDK缺字段时先对照版本说明。不要输出密钥或把它写入清单文件。

Claude网页模型选择器与API目录是不同入口。API读取结果也不能代替一次具体推理请求的权限和额度检查,最终兼容性仍需结合目标工具与账户验证。先用只读目录完成静态筛选,再决定后续测试。

curl https://api.anthropic.com/v1/models \
  -H "anthropic-version: 2026-10-21" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

第二步:按生命周期处理候选模型

active表示可用且未计划退役;deprecated仍可能向既有权限组织提供调用,但不面向新采用者;retired已不可用于推理。默认列表包含active和deprecated,retired需要显式请求。

因此不要把默认列表第一项之外的模型都标成旧版,也不要把deprecated和retired合并成“还能用”。迁移清单保留deprecated_at及实际生命周期,避免用户选择已经不可调用的历史记录。

目录列:id;display_name;lifecycle;deprecated_at;max_input_tokens;line;需要的能力;实际访问检查时间。未提供字段保留未知,不填零或凭名字补造。

第三步:检查能力对象而不是名称关键词

capabilities描述已知能力及支持详情,具体项目可能为空。需要引用、批量处理或工具功能时,读取对应字段和工具文档,不从名字含Opus或数字更大推断功能全开。

例如服务器代码执行应检查capabilities.server_tools.code_execution.supported,顶层code_execution有不同含义。若字段为null、结构变化或未知能力名,应用应记录未知并查文档,不能默认为true。

第四步:正确分页与保留未知值

列表按较新发布模型在前返回,但项目目录不能只取第一页。检查has_more,使用last_id作为下一页after_id游标;遇到重复游标或无进展时停止并记录异常,避免无限请求。

created_at在日期未知时可能是纪元值,不应当作真实发布时间写文章。line可能为空,也会增加新值,不根据id截取字符串猜模型系列。max_input_tokens是token上限,不是可上传文件大小或汉字数。

分页检查:每页模型ID集合;has_more;last_id是否变化;本轮新增数;最大页数或总时限。合并后按id去重,保留完整响应版本和抓取日期。

第五步:将筛选与真实调用验证分开

先筛active、所需输入范围与能力,再用无敏感小任务验证实际请求。模型存在、能力支持、组织有访问权、请求参数正确是不同条件,遇到失败分别定位,不自动换成别的模型而不告知。

把模型目录作为定期更新的数据,不用永久硬编码当前返回值。保存变更差异以发现弃用,升级后对重要任务回归;输出清单只陈述实际读到的字段,本教程未执行付费推理测试。

官方资料

资料核对日期:2026年11月22日。

本文地址:https://www.163264.com/22483