原生 Claude 格式
Anthropic Claude Messages API 格式的请求。需要在请求头中包含 anthropic-version。
注意: 请求头必须包含 anthropic-version(如 2023-06-01)。认证可使用 Authorization: Bearer,也可使用 x-api-key。
示例模型
下文均以 claude-3-opus-20240229(Claude 3 Opus)为例;更换其他模型时,请替换 model 参数,并参考控制台模型说明调整 size、quality 等字段。
创建消息
POST
https://token.easyapi.com/v1/messages使用 Anthropic Claude Messages API 格式创建对话响应。完整路径为 POST /v1/messages。
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
Authorization | header | string | 是 | EasyAPI API Key。格式:Bearer `API_KEY` |
Content-Type | header | string | 是 | 请求体格式,固定 application/json |
anthropic-version | header | string | 是 | Anthropic API 版本,必填,例如 2023-06-01 |
x-api-key | header | string | 否 | Anthropic API Key(可选,也可使用 Bearer Token) |
请求体
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID,示例 claude-3-opus-20240229 |
messages | array<object> | 是 | 对话消息列表,每项含 role 与 content |
max_tokens | integer | 是 | 最大生成 Token 数,范围 ≥ 1 |
system | string | array<object> | 否 | 系统提示,可为字符串或内容块数组 |
temperature | number | 否 | 采样温度,范围 0–1 |
top_p | number | 否 | 核采样参数 |
top_k | integer | 否 | 仅从概率最高的 K 个 token 中采样 |
stream | boolean | 否 | 是否启用流式响应 |
stop_sequences | array<string> | 否 | 自定义停止序列 |
tools | array<object> | 否 | 可调用的工具定义列表 |
tool_choice | object | 否 | 工具选择策略 |
thinking | object | 否 | 扩展思考配置(支持思考的模型) |
metadata | object | 否 | 请求元数据 |
示例
{
"model": "claude-3-opus-20240229",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"max_tokens": 1024
}响应示例
{
"id": "msg_01XFDUDYJgAACzvnptvVoYEL",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello! How can I help you today?"
}
],
"model": "claude-3-opus-20240229",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 10,
"output_tokens": 20,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}