Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Messages (Anthropic)

Buat pesan

Meminta respons model menggunakan format /v1/messages native Anthropic; BazaarLink merutekannya ke model apa pun yang didukung, tidak hanya milik Anthropic sendiri. Arahkan base_url Anthropic SDK resmi ke BazaarLink, kode yang ada tetap berfungsi tanpa perubahan. Menerima baik Authorization: Bearer maupun header x-api-key yang lazim di Anthropic SDK. Jika model yang teresolusi bukan Anthropic native, BazaarLink menerjemahkan permintaan/respons secara transparan, mempertahankan blok tool_use dan semantik stop_reason sebisa mungkin.

POST/api/v1/messages

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

modelwajib

string

Model yang digunakan, dengan prefiks penyedia, mis. "anthropic/claude-sonnet-4.6".

minLength: 1

Example: "anthropic/claude-sonnet-4.6"

messageswajib

Message[]

Array pesan percakapan, minimal satu. Setiap pesan memiliki role (user/assistant) dan content (string, atau array blok konten seperti text/image/tool_use/tool_result).

minLength: 1

max_tokenswajib

integer

Jumlah token maksimum yang dapat dihasilkan respons. Berbeda dari endpoint kompatibel OpenAI, field ini wajib dalam bentuk Anthropic.

positive integer

Example: 1024

system

string | ContentBlock[]

System prompt — field tingkat atas terpisah, bukan pesan di dalam array messages (salah satu perbedaan bentuk utama dari format OpenAI).

stream

boolean

true untuk streaming respons sebagai SSE (event message_start / content_block_delta / message_delta / message_stop); dihilangkan atau false mengembalikan satu respons JSON.

temperature

number

Suhu sampling — semakin tinggi semakin acak, semakin rendah semakin deterministik. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

0–1

top_p

number

Ambang batas nucleus sampling. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

0–1

top_k

integer

Membatasi sampling pada K token dengan probabilitas tertinggi. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

stop_sequences

string[]

Array string yang menghentikan generasi. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

tools

Tool[]

Daftar definisi tool yang dapat dipanggil model, berbentuk Anthropic (name, description, input_schema). Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

tool_choice

object

Mengontrol apakah/bagaimana model dipaksa memanggil tool, mis. {type:"auto"}, {type:"any"}, {type:"tool", name:"..."}. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

thinking

object

Objek kontrol extended thinking, mis. {type:"enabled", budget_tokens:2048}. Hanya berarti pada model reasoning. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi BazaarLink.

metadata

object

Metadata permintaan, mis. {user_id:"..."}. Digunakan untuk pemantauan dan deteksi penyalahgunaan; tidak berpengaruh pada tagihan. Tidak divalidasi oleh BazaarLink — diteruskan apa adanya ke upstream. Jika model yang teresolusi bukan Anthropic native, penanganan field ini bergantung pada lapisan translasi 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"}]
  }'

Contoh respons

Berhasil. Secara default (atau stream: false) mengembalikan objek Message native Anthropic di bawah; dengan stream: true, mengembalikan aliran event SSE (message_start / content_block_delta / message_delta / message_stop — lihat panduan mendalam untuk protokolnya). model selalu mencerminkan nama yang Anda minta (bukan model upstream yang sebenarnya teresolusi). usage mempertahankan field native Anthropic (input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens) ditambah cost/bz_cost — jumlah yang diselesaikan BazaarLink sendiri, bukan nilai yang diteruskan dari 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
  }
}