POST

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

发送 POST 请求时需指定以下请求头。
anthropic-versionstringOptional

Anthropic API 版本号,建议传 2023-06-01。缺省时网关自动填充。

Content-TypestringOptional

通常为 application/json,大多数 SDK 会自动处理。

Request

此端点接收一个 JSON 对象作为请求体。
modelstringRequired

Claude 模型 ID,例如 claude-opus-4-7。具体可用模型以你的 API Key 权限为准。

messagesarray of objectsRequired

Anthropic 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

API 请求失败时可能返回以下 HTTP 状态码:
POST
1import Anthropic from '@anthropic-ai/sdk'
2
3const client = new Anthropic({
4 apiKey: process.env.HY_API_KEY,
5 baseURL: 'https://apiclaw.cc',
6})
7
8const message = await client.messages.create({
9 model: 'claude-opus-4-7',
10 max_tokens: 1024,
11 system: '你是一个专业的产品助手。',
12 messages: [{ role: 'user', content: '解释一下边际成本' }],
13})
14console.log(message.content[0].text)
POST

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可选

遇到这些字符串时停止生成。

REQUEST
1const 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});
19const data = await response.json();
20console.log(data);
RESPONSE

点击 Send request 查看响应

Response
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}