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
  }
}