Create a message
使用 Anthropic Messages 原生格式创建对话,支持多轮上下文、工具调用(Tool Use)和扩展思考(Extended Thinking)。同时兼容 x-api-key 和 Bearer 两种鉴权方式。
Authentication
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
modelstringRequiredClaude 模型 ID,例如 claude-opus-4-7。具体可用模型以你的 API Key 权限为准。
messagesarray of objectsRequiredAnthropic Messages 格式的消息数组,按对话顺序排列。
max_tokensintegerRequired最大输出 token 数量,控制单次回复长度上限。
systemstringOptional系统提示词,用于设定模型行为、角色或背景知识。
streambooleanOptional是否以 SSE 流式返回。默认 false;为 true 时返回 text/event-stream。
thinkingobjectOptional开启 Extended Thinking(扩展思考)。仅部分 Claude 模型支持。
toolsarray of objectsOptional工具(函数)定义列表,开启 Tool Use。
tool_choiceobjectOptional控制模型调用工具的策略。
temperaturenumberOptional采样温度,取值 0–1,越高越发散。开启 thinking 时固定为 1。
top_pnumberOptional核采样概率。与 temperature 互斥,建议只设其中一个。
top_kintegerOptional仅从概率最高的 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必填Claude 模型 ID,例如 claude-opus-4-7。具体可用模型以你的 API Key 权限为准。
messagesarray of objects必填Anthropic Messages 格式的消息数组,按对话顺序排列。
max_tokensinteger必填最大输出 token 数量,控制单次回复长度上限。
systemstring可选系统提示词,用于设定模型行为、角色或背景知识。
streamboolean可选是否以 SSE 流式返回。默认 false;为 true 时返回 text/event-stream。
thinkingobject可选开启 Extended Thinking(扩展思考)。仅部分 Claude 模型支持。
toolsarray of objects可选工具(函数)定义列表,开启 Tool Use。
tool_choiceobject可选控制模型调用工具的策略。
temperaturenumber可选采样温度,取值 0–1,越高越发散。开启 thinking 时固定为 1。
top_pnumber可选核采样概率。与 temperature 互斥,建议只设其中一个。
top_kinteger可选仅从概率最高的 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-7", |
| 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 | } |

