Messages(对话)
发送对话消息并获取回复。max_tokens 必填。旗舰模型上应用 thinking 管理推理深度;stream、system、tools 等与官方一致。
鉴权方式
x-api-keystringOptional在请求头中直接传入 API Key,格式为原始字符串(Anthropic SDK 默认方式)。
AuthorizationstringOptional兼容 OpenAI 风格的 Bearer Token,格式为 Bearer $HY_API_KEY。与 x-api-key 二选一。
Headers
anthropic-versionstringOptionalAnthropic API 版本号,建议传 2023-06-01。缺省时网关自动填充。
Content-TypestringOptional通常为 application/json,大多数 SDK 会自动处理。
Request
modelstringRequired模型 ID,例如 claude-sonnet-4-6、claude-opus-4-7(以控制台绑定为准)
messagesarray of objectsRequiredrole 为 user 或 assistant,content 可为文本或多模态块
max_tokensintegerRequired输出 token 上限(必填)
systemstringOptional系统提示
streambooleanOptionalSSE 流式
thinkingobjectOptionalExtended thinking。推荐 { "type": "adaptive" }(Opus/Sonnet 4.6);或 { "type": "enabled", "budget_tokens": N }(旧式,文档标注将移除)。
toolsarray of objectsOptionalTool definitions
tool_choiceobjectOptional工具选择
temperaturenumberOptional旗舰推理向用法以 thinking / 模型内置行为为主;temperature 对新版对话体验影响有限,可不传。
top_pnumberOptional核采样(与官方一致,可选)
top_kintegerOptionalTop-k 采样(可选)
stop_sequencesarray of stringsOptional停止序列
Errors
| 1 | import Anthropic from '@anthropic-ai/sdk' |
| 2 | |
| 3 | const client = new Anthropic({ |
| 4 | apiKey: process.env.HY_API_KEY, |
| 5 | baseURL: 'https://apiclaw.cc', |
| 6 | }) |
| 7 | |
| 8 | const message = await client.messages.create({ |
| 9 | model: 'claude-opus-4-7', |
| 10 | max_tokens: 1024, |
| 11 | system: '你是一个专业的产品助手。', |
| 12 | messages: [{ role: 'user', content: '解释一下边际成本' }], |
| 13 | }) |
| 14 | console.log(message.content[0].text) |
Authorization
获取 API Key →Body Parameters
modelstring必填模型 ID,例如 claude-sonnet-4-6、claude-opus-4-7(以控制台绑定为准)
messagesarray of objects必填role 为 user 或 assistant,content 可为文本或多模态块
max_tokensinteger必填输出 token 上限(必填)
systemstring可选系统提示
streamboolean可选SSE 流式
thinkingobject可选Extended thinking。推荐 { "type": "adaptive" }(Opus/Sonnet 4.6);或 { "type": "enabled", "budget_tokens": N }(旧式,文档标注将移除)。
toolsarray of objects可选Tool definitions
tool_choiceobject可选工具选择
temperaturenumber可选旗舰推理向用法以 thinking / 模型内置行为为主;temperature 对新版对话体验影响有限,可不传。
top_pnumber可选核采样(与官方一致,可选)
top_kinteger可选Top-k 采样(可选)
stop_sequencesarray of strings可选停止序列
| 1 | const response = await fetch("https://apiclaw.cc/v1/messages", { |
| 2 | method: "POST", |
| 3 | headers: { |
| 4 | "Authorization": "Bearer YOUR_API_KEY", |
| 5 | "Content-Type": "application/json", |
| 6 | }, |
| 7 | body: JSON.stringify({ |
| 8 | "model": "claude-opus-4-8", |
| 9 | "messages": [ |
| 10 | { |
| 11 | "role": "user", |
| 12 | "content": "Hello!" |
| 13 | } |
| 14 | ], |
| 15 | "max_tokens": 1024, |
| 16 | "temperature": 1 |
| 17 | }), |
| 18 | }); |
| 19 | const data = await response.json(); |
| 20 | console.log(data); |
点击 Send request 查看响应
| 1 | { |
| 2 | "id": "msg_abc123", |
| 3 | "type": "message", |
| 4 | "role": "assistant", |
| 5 | "model": "claude-opus-4-7", |
| 6 | "content": [ |
| 7 | { |
| 8 | "type": "text", |
| 9 | "text": "边际成本是指每多生产一个单位产品所增加的总成本。" |
| 10 | } |
| 11 | ], |
| 12 | "stop_reason": "end_turn", |
| 13 | "stop_sequence": null, |
| 14 | "usage": { |
| 15 | "input_tokens": 25, |
| 16 | "output_tokens": 32 |
| 17 | } |
| 18 | } |

