模型接口API文档聊天补全
Claude
Claude Messages 协议模型聚合说明
Claude 系列统一使用 Anthropic Claude Messages 协议兼容接口，不使用 OpenAI 的 messages 响应结构。本页按 Messages 协议说明 Claude 模型的公共调用方式与常见差异。
接口路径
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/messages | 创建 Claude Messages 对话 |
请求结构
{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "请用一句话介绍 Routescope API。"
}
]
}curl -X POST "https://api.routescope.ai/v1/messages" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [ { "role": "user", "content": "你好，请用一句话介绍自己。" } ], "max_tokens": 1024 }'{
"id": "task_01JZ8M9Q4R7V2K8N9P0Q",
"type": "text",
"role": "user",
"content": "你好，请用一句话介绍自己。",
"model": "gpt-4o-mini",
"usage": {
"prompt_tokens": 1,
"completion_tokens": 1,
"total_tokens": 1,
"input_tokens": 1,
"output_tokens": 1
},
"stop_reason": "string"
}Authorization
BearerAuth
AuthorizationBearer <token>
模型 relay 接口鉴权。请求头：Authorization: Bearer 。
In: header
Request Body
application/json
model*string
Claude 模型名称。
messages*
消息数组，通常仅包含 user 与 assistant。 对话消息列表。范围：至少 1 条消息。
system?string|
系统提示。可为字符串或块数组。 system 字符串字段。范围：非空字符串或按业务配置校验。
max_tokens*integer
最大输出 Token。 最大输出 Token 数。范围：1 到模型上下文上限。
Range
1 <= valuetemperature?number
采样温度。 采样温度。范围：0 到 2；值越大输出越随机。
Range
0 <= value <= 2stream?boolean
是否启用流式返回。 是否启用流式输出。范围：true 或 false。
tools?
Claude 工具定义。 工具定义列表。范围：数组长度和 schema 复杂度以上游限制为准。
Response Body
application/json
模型选择表
| 模型 ID | 适用场景 |
|---|---|
claude-haiku-4-5-20251001 | 轻量对话 |
claude-sonnet-4-20250514、claude-sonnet-4-5-20250929、claude-sonnet-4-6 | 通用对话、代码与复杂任务 |
claude-opus-4-20250514、claude-opus-4-1-20250805、claude-opus-4-5-20251101、claude-opus-4-6、claude-opus-4-7 | 高阶复杂任务 |
通用参数
| 字段 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | Claude 模型名称。 |
messages | array | 是 | Claude Messages 消息数组。 |
max_tokens | integer | 是 | 最大输出 Token 数。 |
system | string/array | 否 | 系统提示。 |
temperature | number | 否 | 采样温度。 |
stream | boolean | 否 | 是否流式输出。 |
tools | array | 否 | Claude 工具定义。 |
模型差异参数
| 字段 | 适用模型 | 差异说明 |
|---|---|---|
model | 全部 Claude 模型 | 请求体中传入具体模型 ID。 |
max_tokens | 全部 Claude Messages 请求 | OpenAPI schema 标记为必填，不要遗漏。 |
模型能力和上下文 | 全部 Claude 模型 | 未统一列出不同模型的上下文、价格或专属字段；以接口返回或页面实际展示为准。 |
示例代码
curl https://api.routescope.ai/v1/messages \
-H "Authorization: Bearer $ROUTESCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "请用一句话介绍 Routescope API。" }
]
}'const response = await fetch("https://api.routescope.ai/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.ROUTESCOPE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "claude-sonnet-4-6",
max_tokens: 1024,
messages: [{ role: "user", content: "请用一句话介绍 Routescope API。" }],
}),
});
console.log(await response.json());响应结构
Claude Messages 响应体包含 Claude 内容块数组和用量字段，不要与 OpenAI Chat Completions 的 choices[].message 混用。
最后更新于