Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Messages (Anthropic)

Tạo tin nhắn

Yêu cầu phản hồi mô hình theo định dạng /v1/messages gốc của Anthropic; BazaarLink định tuyến đến bất kỳ model được hỗ trợ nào, không chỉ riêng của Anthropic. Trỏ base_url của Anthropic SDK chính thức vào BazaarLink, mã hiện có vẫn hoạt động không cần sửa. Chấp nhận Authorization: Bearer hoặc header x-api-key theo quy ước của Anthropic SDK. Nếu model được giải quyết không phải Anthropic gốc, BazaarLink dịch minh bạch yêu cầu/phản hồi, giữ nguyên khối tool_use và ngữ nghĩa stop_reason khi có thể.

POST/api/v1/messages

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

modelbắt buộc

string

Model cần dùng, có tiền tố nhà cung cấp, ví dụ "anthropic/claude-sonnet-4.6".

minLength: 1

Example: "anthropic/claude-sonnet-4.6"

messagesbắt buộc

Message[]

Mảng các tin nhắn hội thoại, ít nhất một. Mỗi tin nhắn có role (user/assistant) và content (chuỗi, hoặc mảng các khối nội dung như text/image/tool_use/tool_result).

minLength: 1

max_tokensbắt buộc

integer

Số token tối đa mà phản hồi có thể tạo ra. Khác với các endpoint tương thích OpenAI, trường này bắt buộc trong định dạng Anthropic.

positive integer

Example: 1024

system

string | ContentBlock[]

System prompt — một trường cấp cao nhất riêng biệt, không phải một tin nhắn trong mảng messages (một trong những khác biệt chính so với định dạng OpenAI).

stream

boolean

true để phản hồi dạng luồng SSE (các sự kiện message_start / content_block_delta / message_delta / message_stop); bỏ qua hoặc false trả về một phản hồi JSON đơn.

temperature

number

Nhiệt độ lấy mẫu — càng cao càng ngẫu nhiên, càng thấp càng xác định. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

0–1

top_p

number

Ngưỡng lấy mẫu nhân (nucleus sampling). Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

0–1

top_k

integer

Giới hạn lấy mẫu trong K token có xác suất cao nhất. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

stop_sequences

string[]

Mảng chuỗi khiến việc tạo dừng lại. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

tools

Tool[]

Danh sách định nghĩa tool mà model có thể gọi, theo định dạng Anthropic (name, description, input_schema). Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

tool_choice

object

Kiểm soát việc model có/thế nào bị buộc gọi tool, ví dụ {type:"auto"}, {type:"any"}, {type:"tool", name:"..."}. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

thinking

object

Đối tượng điều khiển extended thinking, ví dụ {type:"enabled", budget_tokens:2048}. Chỉ có ý nghĩa với model reasoning. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của BazaarLink.

metadata

object

Metadata yêu cầu, ví dụ {user_id:"..."}. Dùng để giám sát và phát hiện lạm dụng; không ảnh hưởng thanh toán. Không được BazaarLink xác thực — chuyển tiếp nguyên trạng đến upstream. Nếu model được giải quyết không phải Anthropic gốc, cách xử lý trường này phụ thuộc vào lớp dịch của 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"}]
  }'

Ví dụ phản hồi

Thành công. Mặc định (hoặc stream: false) trả về đối tượng Message nguyên bản của Anthropic bên dưới; với stream: true, trả về luồng sự kiện SSE (message_start / content_block_delta / message_delta / message_stop — xem hướng dẫn chi tiết về giao thức). model luôn phản ánh tên bạn đã yêu cầu (không bao giờ là model upstream thực sự được giải quyết). usage giữ nguyên các trường gốc của Anthropic (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens) cộng thêm cost/bz_cost — số tiền BazaarLink tự quyết toán, không phải giá trị chuyển tiếp từ upstream.

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