Dokumentasi API

Base URL

Arahkan klien OpenAI-compatible Anda ke endpoint berikut.

https://api.hallorouter.com/v1

Buat API key

Masuk ke dashboard, buka menu API Key, lalu buat key. Secret hanya ditampilkan sekali; simpan di environment variable dan jangan commit ke source control.

export HALLOROUTER_API_KEY=hr-...

Daftar model

Ambil katalog yang tersedia untuk key Anda. Gunakan ID model persis seperti yang dikembalikan API.

curl https://api.hallorouter.com/v1/models \
  -H "Authorization: Bearer $HALLOROUTER_API_KEY"

Kirim chat completion

Contoh berikut menggunakan satu ID publik HalloRouter. Ketersediaan tetap mengikuti katalog akun Anda.

curl https://api.hallorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $HALLOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hallo/gpt-5.6-sol","messages":[{"role":"user","content":"Halo"}]}'

Aktifkan streaming

Tambahkan "stream": true untuk menerima respons bertahap melalui SSE.

curl https://api.hallorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $HALLOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hallo/gpt-5.6-sol","stream":true,"messages":[{"role":"user","content":"Halo"}]}'

Error umum

401

API key hilang, tidak valid, atau sudah dicabut.

400

Payload atau ID model tidak valid. Periksa respons JSON untuk detail.

429

Request tidak dapat diproses saat ini. Gunakan retry dengan jeda bertahap.

Jangan menaruh API key di browser atau repository publik. Rotasi key dari dashboard jika secret terpapar.