Dokumentasi Referensi API Referensi SDK Penggunaan Agentik Skill AI

Chat

Buat chat

Meminta respons model untuk percakapan chat yang diberikan. Mendukung mode streaming maupun non-streaming, dengan satu bentuk permintaan/respons kompatibel OpenAI di semua model dan penyedia.

POST/api/v1/chat/completions

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

modelwajib

string

Model yang digunakan, dengan prefiks penyedia, mis. "openai/gpt-4.1". Id singkat dari keluarga model umum (mis. "gpt-4o") secara otomatis diresolusi ke id canonical lengkap ("openai/gpt-4o"); nilai yang sudah berbentuk canonical diteruskan apa adanya. Id singkat yang tidak dikenali tidak ditulis ulang paksa — resolusi model akan mengembalikan error model-not-found yang jelas.

minLength: 1

Example: "openai/gpt-4.1"

messageswajib

Message[]

Array pesan percakapan, minimal satu. Setiap pesan memiliki role (system/user/assistant/tool) dan content.

minLength: 1

models

string[]

Daftar model fallback — dicoba berurutan, hanya digunakan setelah grup kandidat model utama habis.

stream

boolean

true untuk streaming respons sebagai SSE; dihilangkan atau false mengembalikan satu respons JSON.

temperature

number

Suhu sampling — semakin tinggi semakin acak, semakin rendah semakin deterministik.

0–2

max_tokens

integer

Jumlah token maksimum yang dapat dihasilkan respons.

max_completion_tokens

integer

Alias dari max_tokens dengan semantik identik.

top_p

number

Ambang batas nucleus sampling.

0–1

top_k

integer

Membatasi sampling pada K token dengan probabilitas tertinggi.

frequency_penalty

number

Memberi penalti pada token berdasarkan seberapa sering sudah muncul.

-2.0–2.0

presence_penalty

number

Memberi penalti pada token berdasarkan apakah sudah pernah muncul, tanpa memandang jumlahnya.

-2.0–2.0

repetition_penalty

number

Koefisien penalti pengulangan — mekanisme terpisah dari frequency/presence penalty.

min_p

number

Ambang probabilitas minimum relatif terhadap token paling mungkin.

0–1

top_a

number

Mekanisme sampling cutoff dinamis lainnya, menskalakan ambang dengan kuadrat probabilitas tertinggi.

seed

integer

Seed sampling deterministik; tidak semua penyedia menjamin reproduktifitas.

n

integer

Jumlah respons yang dihasilkan.

stop

string | string[]

Urutan yang menghentikan generasi, maksimal 4.

tools

Tool[]

Daftar definisi tool/fungsi yang dapat dipanggil model.

tool_choice

string | object

Mengontrol apakah/bagaimana model dipaksa memanggil tool.

parallel_tool_calls

boolean

Apakah mengizinkan pemanggilan tool paralel saat tools disediakan. Default true. Hanya model keluarga OpenAI — dihapus secara diam-diam saat model target bukan milik OpenAI, bukan error.

response_format

object

Membatasi format output, mis. {type:"json_object"} atau {type:"json_schema"} dengan JSON Schema.

logit_bias

object

Memetakan ID token ke nilai bias [-100, 100] yang ditambahkan sebelum sampling. Hanya model keluarga OpenAI — dihapus secara diam-diam saat model target bukan milik OpenAI, bukan error.

logprobs

boolean

Mengembalikan probabilitas log dari setiap token output. Hanya model keluarga OpenAI — dihapus secara diam-diam saat model target bukan milik OpenAI, bukan error.

top_logprobs

integer

Jumlah token paling mungkin yang dikembalikan per posisi (memerlukan logprobs: true). Hanya model keluarga OpenAI — dihapus secara diam-diam saat model target bukan milik OpenAI, bukan error.

0–20

user

string

Pengidentifikasi pengguna akhir untuk pemantauan dan deteksi penyalahgunaan. Tidak berpengaruh pada tagihan. Hanya model keluarga OpenAI — dihapus secara diam-diam saat model target bukan milik OpenAI, bukan error.

reasoning

object

Objek kontrol pemikiran model reasoning (mis. {effort, max_tokens}).

reasoning_effort

string

Field singkat datar untuk reasoning.effort.

lowmediumhigh

image_config

object

Opsi generasi/edit gambar (digunakan saat modalities menyertakan image).

modalities

string[]

Modalitas output yang diminta. Menyertakan image mengarahkan melalui jalur dispatch pembuatan gambar.

textimage

plugins

object[]

Array plugin (mis. {id:"web"} untuk mengaktifkan pencarian web). Hanya didukung pada beberapa rute model, tanpa efek di tempat lain; varian model :online otomatis menyisipkan {id:"web"}, juga hanya pada rute yang mendukung.

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

Contoh respons

Berhasil. BazaarLink hanya menormalkan dua field — model, dan penghapusan field provider — lalu meneruskan sisa respons upstream apa adanya, termasuk field seperti native_finish_reason, system_fingerprint, dan reasoning yang hanya ada jika penyedia tersebut mengisinya. usage.cost adalah pengecualian — selalu 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": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}