POST /v1/messages — Claude 原生格式

/v1/messages 端点接受 Anthropic 原生 Claude Messages API 格式的请求。如果你已使用 anthropic Python 或 JavaScript SDK，只需修改 base URL 即可将请求指向 Anyone——所有请求和响应字段完全一致。Anyone 使用你控制台中的 token 进行认证，并将请求路由到配置好的 Claude 渠道。你也可以将 Claude 格式的请求发送到非 Claude 上游渠道，Anyone 会自动转换格式。

端点

POST /v1/messages

认证

Claude Messages 请求使用两个头（非 Authorization）：

头字段	是否必需	说明
`x-api-key`	是	你的 Anyone API key
`anthropic-version`	是	必须为 `2023-06-01`

如果你的客户端不支持 x-api-key，也可使用 Authorization: Bearer YOUR_TOKEN。Anyone 两种方式都接受。

请求参数

model

string

必填

要使用的 Claude 模型，例如 claude-opus-4-6 或 claude-sonnet-4-6。要启用扩展思考，使用 -thinking 模型名后缀：claude-sonnet-4-6-thinking。

messages

object[]

必填

对话历史。消息在 user 和 assistant 角色间交替。第一条消息必须是 user 角色。

显示消息属性

messages[].role

string

必填

消息作者角色。可选 "user" 或 "assistant"。

messages[].content

string | object[]

必填

消息内容。纯文本传字符串，多模态输入传内容块数组。每个内容块是一个带 type 字段的对象。支持的类型：

"text" — 文本块，含 text 字段
"image" — 图片块，含 source 对象（包含 type（"base64" 或 "url"）、media_type 和 data 或 url）
"tool_use" — 模型生成的 tool calling，含 id、name 和 input
"tool_result" — tool calling 的结果，含 tool_use_id 和 content

max_tokens

integer

必填

最大生成 token 数。Claude Messages API 要求此字段必填。值不得超过模型的输出 token 限制。

system

string | object[]

系统提示词，为对话设置上下文和指令。传字符串，或传内容块数组用于高级场景（如缓存系统提示词）。

stream

boolean

默认值:"false"

设为 true 时，响应以 Anthropic 流式格式的 SSE 返回。事件类型包括 message_start、content_block_start、content_block_delta、content_block_stop、message_delta 和 message_stop。

temperature

number

采样温度，范围 0 到 1。值越高输出越多样。

top_p

number

核采样概率质量，取值 0 到 1。建议在不设 temperature 时使用。

top_k

integer

仅从最可能的前 k 个 token 中采样。大多数场景不建议使用。

stop_sequences

string[]

自定义停止序列。模型遇到这些序列时停止生成，输出不包含停止序列本身。

tools

object[]

模型可调用的工具。每个工具定义一个可调用的函数。

显示工具属性

tools[].name

string

必填

工具名称。必须匹配 ^[a-zA-Z0-9_-]{1,64}$。

tools[].description

string

工具功能描述。模型根据此描述决定何时调用。

tools[].input_schema

object

必填

工具的输入参数，JSON Schema 格式。顶层必须为 type: "object"，包含 properties 映射和可选的 required 数组。

tool_choice

object

控制模型如何选择工具。

显示 tool_choice 属性

tool_choice.type

string

必填

可选 "auto"（模型决定）、"any"（必须调用工具）或 "tool"（必须调用指定工具）。

tool_choice.name

string

当 type 为 "tool" 时必填。要调用的工具名称。

tool_choice.disable_parallel_tool_use

boolean

默认值:"false"

设为 true 时，模型每次只能调用一个工具。

thinking

object

为支持的模型启用扩展思考。也可使用 -thinking 模型名后缀作为替代。

显示 thinking 属性

thinking.type

string

必填

必须为 "enabled"。

thinking.budget_tokens

integer

模型在生成响应前可用于内部推理的最大 token 数。

响应字段

string

此消息的唯一标识符，格式为 msg_...。

type

string

完整响应始终为 "message"。

role

string

生成消息的角色，始终为 "assistant"。

content

object[]

响应中的内容块数组。

显示内容块属性

content[].type

string

块类型："text" 为文本输出，"tool_use" 为模型调用工具，"thinking" 为扩展思考内容。

content[].text

string

文本内容。type 为 "text" 时出现。

content[].id

string

tool call ID。type 为 "tool_use" 时出现。

content[].name

string

工具名称。type 为 "tool_use" 时出现。

content[].input

object

tool calling 参数。type 为 "tool_use" 时出现。

content[].thinking

string

模型的推理内容。type 为 "thinking" 且启用扩展思考时出现。

model

string

生成响应的模型。

stop_reason

string

模型停止生成的原因。可选值："end_turn"（自然结束）、"max_tokens"（达到 token 限制）、"stop_sequence"（匹配自定义停止序列）或 "tool_use"（模型调用了工具）。

usage

object

此次请求的 token 用量统计。

显示 usage 属性

usage.input_tokens

integer

输入消息和系统提示词中的 token 数量。

usage.output_tokens

integer

生成响应中的 token 数量。

usage.cache_creation_input_tokens

integer

写入提示词缓存的 token 数量（使用缓存时）。

usage.cache_read_input_tokens

integer

从提示词缓存读取的 token 数量（使用缓存时）。

示例

非流式
流式
Tool calling

curl https://api.anyone.ai/v1/messages \
  -H "x-api-key: YOUR_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "system": "You are a concise technical assistant.",
    "messages": [
      {"role": "user", "content": "Explain what a mutex is in one paragraph."}
    ]
  }'

响应示例：

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "A mutex (mutual exclusion lock) is a synchronization primitive that ensures only one thread can access a shared resource at a time..."
    }
  ],
  "model": "claude-opus-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 28,
    "output_tokens": 87,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

cURL

curl https://api.anyone.ai/v1/messages \
  -H "x-api-key: YOUR_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 512,
    "stream": true,
    "messages": [
      {"role": "user", "content": "Write a haiku about databases."}
    ]
  }'

服务端以 Anthropic 流式格式发送事件：

event: message_start
data: {"type":"message_start","message":{"id":"msg_01abc","type":"message","role":"assistant","content":[],"model":"claude-opus-4-6","stop_reason":null,"usage":{"input_tokens":14,"output_tokens":0}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Rows"}}

event: message_stop
data: {"type":"message_stop"}

cURL

curl https://api.anyone.ai/v1/messages \
  -H "x-api-key: YOUR_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather for a location.",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City name, e.g. San Francisco"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {"role": "user", "content": "What is the weather in Tokyo?"}
    ]
  }'

格式转换

你也可以将 Claude 格式请求（/v1/messages）路由到非 Claude 上游渠道。Anyone 自动进行格式转换，将 Claude Messages 格式翻译为上游服务商的原生格式。这让你可以用单一客户端格式跨服务商调用。转换为尽力而为；某些 Claude 特有功能（如扩展思考）可能在所有上游渠道中不可用。

Documentation Index

​端点

​认证

​请求参数

​响应字段

​示例

​格式转换

端点

认证

请求参数

响应字段

示例

格式转换