语言
中文
POST

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

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

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

Content-TypestringOptional

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

Request

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

模型 ID,例如 claude-sonnet-4-6、claude-opus-4-7(以控制台绑定为准)

messagesarray of objectsRequired

role 为 user 或 assistant,content 可为文本或多模态块

max_tokensintegerRequired

输出 token 上限(必填)

systemstringOptional

系统提示

streambooleanOptional

SSE 流式

thinkingobjectOptional

Extended thinking。推荐 { "type": "adaptive" }(Opus/Sonnet 4.6);或 { "type": "enabled", "budget_tokens": N }(旧式,文档标注将移除)。

toolsarray of objectsOptional

Tool definitions

tool_choiceobjectOptional

工具选择

temperaturenumberOptional

旗舰推理向用法以 thinking / 模型内置行为为主;temperature 对新版对话体验影响有限,可不传。

top_pnumberOptional

核采样(与官方一致,可选)

top_kintegerOptional

Top-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必填

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

停止序列

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-8",
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}