Anthropic 文本接口
接口地址
POST https://www.moyu.info/v1/messages请求示例
cURL
其他语言
响应格式
{
"id": "msg_01BmUFLDDHz14v9zoEACmRR1",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello! How can I help you today?"
}
],
"model": "claude-sonnet-4-5-20250929",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 13,
"output_tokens": 15,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}请求参数
必需 Header
| Header | 值 | 说明 |
|---|---|---|
| anthropic-version | 2023-06-01 | API 版本号，必需 |
| Authorization | Bearer YOUR_API_KEY | 认证令牌（二选一） |
| x-api-key | YOUR_API_KEY | Anthropic 原生鉴权头（二选一），官方 SDK 默认发送此头，本平台会转换为 Authorization |
鉴权头 Authorization: Bearer与x-api-key任选其一即可。用官方 Anthropic SDK 的客户默认走x-api-key，本平台同样支持，无需改造。
基础参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，如 claude-sonnet-4-5-20250929, claude-opus-4-5-20251101 等 |
| messages | array | 是 | 对话消息列表 |
| max_tokens | integer | 是 | 生成的最大 token 数量 |
messages 格式
[
{
"role": "user",
"content": "Hello"
}
]user: 用户消息assistant: 助手的回复（用于多轮对话）系统提示参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| system | string | 否 | 系统提示，用于设定 Claude 的行为和角色 |
采样参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| temperature | number | 否 | 1.0 | 采样温度，范围 0-1。较高的值使输出更随机，较低的值使输出更确定 |
| top_p | number | 否 | - | 核采样参数，范围 0-1。注意：不能与 temperature 同时使用 |
| top_k | integer | 否 | - | Top-K 采样参数，仅从前 k 个最可能的 token 中采样 |
控制参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stop_sequences | array | 否 | - | 停止序列列表，最多 4 个。遇到时 API 将停止生成 |
| stream | boolean | 否 | false | 是否流式输出。true 时使用 Server-Sent Events (SSE) |
高级参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| metadata | object | 否 | 元数据对象，可包含 user_id 等信息用于追踪 |
| tools | array | 否 | 工具列表，用于函数调用等高级功能 |
| tool_choice | object | 否 | 工具选择策略 |
| thinking | object | 否 | 思考配置（扩展思维模式） |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 消息的唯一标识符 |
| type | string | 对象类型，固定为 message |
| role | string | 角色，固定为 assistant |
| content | array | 内容块数组 |
| content[].type | string | 内容类型，如 text |
| content[].text | string | 生成的文本内容 |
| model | string | 使用的模型名称 |
| stop_reason | string | 停止原因：end_turn(自然结束)、max_tokens(达到长度限制)、stop_sequence(遇到停止序列) |
| stop_sequence | string | 触发停止的序列（仅当 stop_reason 为 stop_sequence 时存在） |
| usage | object | token 使用情况统计 |
| usage.input_tokens | integer | 输入 token 数 |
| usage.output_tokens | integer | 输出 token 数 |
| usage.cache_creation_input_tokens | integer | 缓存创建的输入 token 数（首次写入缓存时产生，未创建缓存时为 0） |
| usage.cache_read_input_tokens | integer | 缓存命中的输入 token 数（命中已有缓存时产生，未命中时为 0） |
修改于 2026-08-05 01:35:02