Messages（Anthropic 兼容）

创建消息

以 Anthropic 原生的 /v1/messages 请求格式获取模型回应,BazaarLink 会路由到任何支持的模型(不限 Anthropic)。把官方 Anthropic SDK 的 base_url 指向 BazaarLink,现有代码即可不改直接用。可用 Authorization: Bearer 或 Anthropic SDK 惯用的 x-api-key 标头验证。若目标模型非原生 Anthropic,BazaarLink 会透明转译请求/响应,尽量保留 tool_use 区块与 stop_reason 语义。

POST/api/v1/messages

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

Body

model必填

string

要使用的模型,供应商前缀格式,例如 "anthropic/claude-sonnet-4.6"。

minLength: 1

Example: "anthropic/claude-sonnet-4.6"

messages必填

Message[]

对话消息数组,至少一条。每条含 role(user/assistant)与 content(字符串或内容区块数组,如 text/image/tool_use/tool_result)。

minLength: 1

max_tokens必填

integer

响应可生成的最大 token 数。与 OpenAI 兼容端点不同,这个字段在 Anthropic 格式中是必填的。

positive integer

Example: 1024

system

string | ContentBlock[]

系统提示——独立于 messages 之外的顶层字段,而非 messages 数组里的一条消息(这是 Anthropic 与 OpenAI 格式的主要差异之一)。

stream

boolean

true 时以 SSE 串流回应(message_start / content_block_delta / message_delta / message_stop 等事件);省略或 false 为一次性 JSON 回应。

temperature

number

采样温度,越高越随机、越低越确定。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

0–1

top_p

number

核采样(nucleus sampling)阈值。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

0–1

top_k

integer

限制采样时只从概率最高的 K 个 token 中选。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

stop_sequences

string[]

遇到即停止生成的字符串数组。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

tools

Tool[]

模型可调用的工具定义列表,Anthropic 格式(name、description、input_schema)。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

tool_choice

object

控制模型是否/如何被强制调用工具,例如 {type:"auto"}、{type:"any"}、{type:"tool", name:"..."}。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

thinking

object

扩展思考控制对象,例如 {type:"enabled", budget_tokens:2048}。仅推理模型有意义。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

metadata

object

请求元数据,例如 {user_id:"..."}。用于监控与滥用侦测,对计费无影响。本字段不经 BazaarLink 验证,原样转发给上游。若目标模型并非原生 Anthropic,实际处理方式取决于 BazaarLink 的转译层。

POST /api/v1/messages

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/messages \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

响应示例

成功。默认(或 stream: false)返回如下的 Anthropic 原生形状 Message 对象;stream: true 时改返回 SSE 事件流(message_start / content_block_delta / message_delta / message_stop,协议见深度指南)。model 一律返回你请求时传入的名称(不会泄露实际解析的上游模型)。usage 保留 Anthropic 原生字段(input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens),另外加上 cost/bz_cost(BazaarLink 自己结算的金额)——绝不是上游转发的原始成本。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "anthropic/claude-sonnet-4.6",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cost": 0.000186,
    "bz_cost": 0.000186
  }
}