Claude API调用手册

读取组织可用模型

查询直连模型 ID 和分页信息,为应用配置模型选择。

官方资料核对 2026-10-15示例代码,未进行真实接口实测
← 返回平台功能

接入准备

  • 拥有官方直连 Console Key。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行;密钥不应放进公开网页。

ANTHROPIC_API_KEY
在 Claude Console 创建绑定单一工作区的 API Key,不使用 App 登录凭证。
终端
export ANTHROPIC_API_KEY='replace_with_your_claude_api_key'

以上 export 适用于 macOS / Linux 的终端。按调用步骤保存代码文件,再在同一终端执行。

调用步骤

  1. 01

    以同一工作区 Key 请求 GET /v1/models。

  2. 02

    读取 data 与 has_more,有下一页时把 last_id 放入 after_id 继续。

调用 01

列出模型第一页

每页读取 20 条,不提交推理任务。

GEThttps://api.anthropic.com/v1/models?limit=20

请求头

Authorization
Bearer ${ANTHROPIC_API_KEY}
anthropic-version
2023-06-01
Content-Type
application/json

参数说明

参数表可左右滑动,查看完整说明。

字段 / 位置类型 / 必填说明
limitQueryinteger可选本例 20,取值 1 到 1000。
after_idQuerystring可选下一页填上一页 last_id。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。

cURL
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request GET \
  --url "https://api.anthropic.com/v1/models?limit=20" \
  --header "Authorization: Bearer ${ANTHROPIC_API_KEY}" \
  --header "anthropic-version: 2023-06-01" \
  --header "Content-Type: application/json"
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.anthropic.com/v1/models?limit=20")
headers = {
    "Authorization": expand("Bearer ${ANTHROPIC_API_KEY}"),
    "anthropic-version": expand("2023-06-01"),
    "Content-Type": expand("application/json"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
Node.js
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.anthropic.com/v1/models?limit=20");
const headers = Object.fromEntries(
  Object.entries({
  "Authorization": "Bearer ${ANTHROPIC_API_KEY}",
  "anthropic-version": "2023-06-01",
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

虚构节选示意,非完整模型清单或实测结果。 以下为结构示意,非本站实测结果。

JSON
{
  "data": [
    {
      "id": "claude-haiku-5-5",
      "type": "model",
      "display_name": "Claude Haiku 5.5"
    }
  ],
  "first_id": "claude-haiku-5-5",
  "last_id": "claude-haiku-5-5",
  "has_more": false
}

常见错误与排查

HTTP 401 authentication_error密钥认证失败。
确认是有效 Console Key,不混用 App 会话或其他云平台密钥。
HTTP 400 invalid_request_error参数、模型或工作区配置无效。
根据错误 message 核对模型、内容块、版本头和 Key 类型。
HTTP 429 rate_limit_error组织或工作区触发限流。
读取 retry-after 并退避,减少并发或输出预算。

调用注意

  • 默认列表含 active 和 deprecated,模型退役状态需要按 lifecycle 单独判断。

注意事项

  • 返回模型不代表全部模态与 Beta 功能都可直接使用;按对应模型文档配置。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
    API 认证与工作区核验日期 2026-10-15
  2. 02
    HTTP 错误核验日期 2026-10-15
  3. 03
    模型价格核验日期 2026-10-15
  4. 04
    List Models核验日期 2026-10-15

Claude API的其他调用手册

← 返回Claude API的全部功能