Messages(官方Anthropic格式)

方法: POST路径: /v1/messages

该接口用于按 Anthropic Messages 格式调用可用的 Claude / LLM 模型。请求地址为 {BaseURL}/v1/messages，Base URL 与 API Key 的获取方式见 获取 Base URL 和 API Key。

最小文本请求

请求参数

Header 参数

Authorization
string
必填
默认值:
Bearer YOUR_API_KEY

Content-Type
string
必填
默认值:
application/json

anthropic-version
string
可选
示例:
2023-06-01

Body 参数 application/json

object
示例
{
  "model": "claude-3-5-sonnet-20240620",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hello, Claude format."
        }
      ]
    }
  ]
}

常用字段：

字段	类型	必填	说明
model	string	是	模型名称。可通过 列出模型 查看账号可用模型。
max_tokens	number	是	最大输出 token 数。
messages	array	是	Anthropic Messages 格式的消息数组。
messages[].role	string	是	通常为 user 或 assistant。
messages[].content	array	是	内容块数组，文本块使用 { "type": "text", "text": "..." }。
stream	boolean	否	是否使用流式响应，按上游模型能力决定。

请求示例代码

Shell

curl --location --request POST '{BaseURL}/v1/messages' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "claude-3-5-sonnet-20240620",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Hello, Claude format."
        }
      ]
    }
  ]
}'

图片请求

图片理解也走同一个 /v1/messages 端点，content 中加入 image 内容块即可。示例见 Messages(识图)。

迁移提示

• 如果你原来调用 Anthropic 官方 API，通常只需要替换 Base URL 与 API Key，并确认 model 名称在当前账号可用。
• 如果你原来调用 OpenAI Chat Completions，端点需要从 /v1/chat/completions 改为 /v1/messages，并把消息内容改成 Anthropic 内容块格式。
• 不要在前端公开代码、日志、截图或 GitHub 中暴露 API Key。

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello. How can I help?"
    }
  ],
  "model": "claude-3-5-sonnet-20240620",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}