跳到主要内容
API 参考

Messages 接口(Anthropic 兼容)

接口说明

Messages 接口(Anthropic 兼容)

接口说明​

  • 方法:POST
  • 路径:/v1/messages
  • 完整地址:https://anideaai.com/v1/messages
  • 用途:使用 Anthropic Messages 请求格式调用模型。

请求头​

请求头必填说明
Authorization是Bearer sk-xxxxx
anthropic-version是例如 2023-06-01
Content-Type是application/json
x-api-key否Anthropic 兼容头,可选

主要请求参数​

参数类型必填说明
modelstring是模型名称
messagesarray是消息数组(user/assistant)
max_tokensinteger是最大输出长度
systemstring/array否系统提示
temperaturenumber否随机性(0~1)
top_pnumber否核采样
top_kinteger否候选采样
streamboolean否是否流式
stop_sequencesarray否停止序列
toolsarray否工具定义(含 input_schema)
tool_choiceobject否工具策略(auto/any/tool)
thinkingobject否推理开关与预算

cURL 示例​

curl https://anideaai.com/v1/messages \
-H "Authorization: Bearer sk-xxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 512,
"messages": [
{"role": "user", "content": "请给一份一周健身计划"}
]
}'

响应示例​

{
"id": "msg_01abc",
"type": "message",
"role": "assistant",
"model": "claude-opus-4-6",
"content": [
{"type": "text", "text": "下面是一份可执行的一周健身计划..."}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 120,
"output_tokens": 260,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0
}
}

流式说明​

stream=true 时返回事件流,事件类型可能包含 message_start、content_block_delta、message_stop。不同模型事件细节会略有差异。

与 Chat Completions 的主要区别​

维度Messages APIChat Completions API
端点/v1/messages/v1/chat/completions
版本头需要 anthropic-version不需要
消息结构更接近 Anthropic 风格OpenAI 风格
工具字段input_schemaparameters
返回内容content 数组块choices[].message
这页有帮助吗?