POST /v1/messages

兼容 Anthropic Messages API 原生格式
支持 Anthropic 官方 SDK（Python / JavaScript）直接对接，仅需修改 base_url
支持流式输出（SSE）
支持多轮对话、系统提示词、视觉输入、工具调用

注意： 如果你已经在使用 OpenAI SDK，建议使用 OpenAI 格式接口。如果你在使用 Anthropic SDK 或 Claude Code，推荐使用本接口。

Authorizations

Authorizationstring

Bearer Token 认证，适用于直接 HTTP 调用

Authorization: Bearer YOUR_API_KEY

x-api-keystring

API Key 认证，与 Anthropic SDK 兼容

x-api-key: YOUR_API_KEY

anthropic-versionstring默认 2023-06-01

Anthropic API 版本号，使用 Anthropic SDK 时自动传入

推荐值：2023-06-01

Body

modelstring必填

模型名称

支持所有 Claude 系列模型，例如：

claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5

messagesobject[]必填

对话消息列表，按时间顺序排列。只支持 user 和 assistant 角色，系统提示词请使用顶层 system 字段

显示隐藏 messages[n]

rolestring必填

消息角色，可选值：user、assistant

contentstring | object[]必填

消息内容，字符串或内容块数组

显示隐藏内容块（content block）

typestring必填

内容类型：text（文本）或 image（图片）

textstring

文本内容，type 为 text 时必填

sourceobject

图片来源，type 为 image 时必填

显示隐藏 source

typestring必填

图片来源类型：base64 或 url

media_typestring

MIME 类型，type 为 base64 时必填，例如 image/jpeg、image/png

datastring

Base64 编码的图片数据，type 为 base64 时必填

urlstring

图片 URL，type 为 url 时必填

max_tokensinteger必填

生成内容的最大 token 数量

Claude Sonnet 4-6 最大支持 64000
Claude Opus 4-6 最大支持 32000

systemstring | object[]

系统提示词，在顶层设置（不放在 messages 中）

支持字符串或内容块数组格式

streamboolean默认 false

是否启用流式输出（Server-Sent Events）

true：逐 token 流式返回，事件格式遵循 Anthropic SSE 规范
false：等待完整响应后一次性返回

temperaturenumber默认 1

采样温度，控制输出随机性

范围：0 ~ 1

top_pnumber

核采样概率阈值

范围：0 ~ 1，建议不要同时设置 temperature 和 top_p

stop_sequencesstring[]

停止序列，遇到指定字符串时停止生成

Response

idstring

本次请求的唯一标识符，格式为 msg_*

typestring

对象类型，固定为 message

rolestring

响应角色，固定为 assistant

contentobject[]

生成的内容块列表

content[].type：内容类型，通常为 text
content[].text：生成的文本内容

modelstring

实际使用的模型名称

stop_reasonstring

停止原因

end_turn：模型正常结束
max_tokens：达到 max_tokens 限制
stop_sequence：触发了停止序列

usageobject

本次请求的 token 消耗统计

usage.input_tokens：输入 token 数
usage.output_tokens：输出 token 数

Anthropic Messages API

Authorizations

Body

Response