Claude API调用手册
发送文本并读取回答
用 Messages API 生成短文本,检查内容块、停止原因和用量。
← 返回平台功能接入准备
- 拥有单一工作区 API Key 和可用 credits。
- 本例使用正式推理,会产生组织用量。
准备环境变量
示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行;密钥不应放进公开网页。
ANTHROPIC_API_KEY- 在 Claude Console 创建绑定单一工作区的 API Key,不使用 App 登录凭证。
export ANTHROPIC_API_KEY='replace_with_your_claude_api_key'以上 export 适用于 macOS / Linux 的终端。按调用步骤保存代码文件,再在同一终端执行。
调用步骤
- 01
设置 ANTHROPIC_API_KEY,使用当前直连模型 ID。
- 02
执行下方任一语言的非流式请求。
- 03
筛选 content 中 type=text 的内容,同时核对 stop_reason 和 usage。
调用 01
创建模型回复
使用短输入和有限输出,验证最小消息请求。
POST
https://api.anthropic.com/v1/messages请求头
AuthorizationBearer ${ANTHROPIC_API_KEY}anthropic-version2023-06-01Content-Typeapplication/json
参数说明
参数表可左右滑动,查看完整说明。
| 字段 / 位置 | 类型 / 必填 | 说明 |
|---|---|---|
model请求体 | string必填 | 本例 claude-haiku-5-5,实际可用性按组织确认。 |
max_tokens请求体 | integer必填 | 最大生成预算,本例 512。 |
messages请求体 | array必填 | 每条包含 role 与 content,本例只有 user 文本。 |
stream请求体 | boolean可选 | 本例 false,完整 JSON 返回。 |
调用代码
替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。
cat > request-body.json <<'JSON'
{
"model": "claude-haiku-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "用一句中文概括:本周接通测试接口,再检查超时和错误处理。"
}
],
"stream": false
}
JSON
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.anthropic.com/v1/messages" \
--header "Authorization: Bearer ${ANTHROPIC_API_KEY}" \
--header "anthropic-version: 2023-06-01" \
--header "Content-Type: application/json" \
--data-binary @request-body.json
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/messages")
headers = {
"Authorization": expand("Bearer ${ANTHROPIC_API_KEY}"),
"anthropic-version": expand("2023-06-01"),
"Content-Type": expand("application/json"),
}
body = {
"model": "claude-haiku-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "用一句中文概括:本周接通测试接口,再检查超时和错误处理。",
},
],
"stream": False,
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
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 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/messages");
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 body = {
"model": "claude-haiku-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "用一句中文概括:本周接通测试接口,再检查超时和错误处理。"
}
],
"stream": false
};
const response = await fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
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));
返回示例
虚构结构示意,非实测;content 为数组,数字仅作字段说明。 以下为结构示意,非本站实测结果。
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-haiku-5-5",
"content": [
{
"type": "text",
"text": "本周先接通测试接口,再验证超时与错误处理。"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 30,
"output_tokens": 22
}
}常见错误与排查
HTTP 401 authentication_error密钥认证失败。- 确认是有效 Console Key,不混用 App 会话或其他云平台密钥。
HTTP 400 invalid_request_error参数、模型或工作区配置无效。- 根据错误 message 核对模型、内容块、版本头和 Key 类型。
HTTP 429 rate_limit_error组织或工作区触发限流。- 读取 retry-after 并退避,减少并发或输出预算。
HTTP 529 overloaded_error服务当前过载。- 延迟后重试并记录 request-id,不立即并发重放。
调用注意
- stop_reason=max_tokens 可能意味着输出截断,不能直接视为完整结果。
注意事项
- 代码打印完整 JSON;正式业务中遍历 content 并处理不同块类型。
- 改为 stream=true 时必须实现 SSE 客户端,不沿用本例的 JSON 一次性解析。
核验来源
本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。
- 01API 认证与工作区核验日期 2026-10-15
- 02HTTP 错误核验日期 2026-10-15
- 03模型价格核验日期 2026-10-15
- 04Create a Message核验日期 2026-10-15