Memulai
Autentikasi
Autentikasi setiap request dengan API key dari konsol, di header Authorization atau x-api-key.
Setiap request ke https://api.larasrouter.com/v1 wajib membawa API key. Kunci dimiliki oleh organisasi Anda, dan setiap request yang memakai kunci tersebut ditagihkan ke wallet organisasi.
Kirim kunci
Gunakan salah satu header berikut. Keduanya diterima di semua endpoint:
curl https://api.larasrouter.com/v1/models \
-H "Authorization: Bearer $LARAS_API_KEY"
curl https://api.larasrouter.com/v1/models \
-H "x-api-key: $LARAS_API_KEY"
SDK OpenAI otomatis mengirim Authorization: Bearer. Sebagian tool hanya menyediakan kolom x-api-key; itu juga bisa dipakai.
Request tanpa kunci yang valid gagal dengan 401 invalid_api_key. Kunci yang ada tetapi tidak memiliki scope chat:write gagal dengan 403 insufficient_scope.
Format kunci
Kunci produksi berbentuk lr_live_<prefix>_<secret>. Konsol menampilkan kunci lengkap hanya sekali, saat Anda membuatnya. Setelah itu konsol hanya menampilkan prefix-nya, supaya Anda bisa membedakan kunci tanpa membukanya. Kami hanya menyimpan hash satu arah dari secret dan tidak bisa memulihkan kunci yang hilang — buat kunci baru sebagai gantinya.
Variabel lingkungan
SDK resmi OpenAI membaca variabel berikut, jadi banyak tool langsung bisa dipakai tanpa mengubah kode:
export OPENAI_BASE_URL="https://api.larasrouter.com/v1"
export OPENAI_API_KEY="lr_live_your_key_here"
Batas pada kunci
Setiap kunci punya batasnya sendiri, terpisah dari kunci Anda yang lain:
| Batas | Default | Jika terlampaui |
|---|---|---|
| Request per menit | 300 | 429 rate_limit_exceeded |
| Request bersamaan | 16 | 429 concurrency_limit_exceeded |
| Anggaran bulanan (USD) | Tidak ada | 402 key_budget_exceeded |
Tetapkan anggaran bulanan untuk setiap kunci di konsol, supaya satu environment tidak bisa menghabiskan seluruh saldo wallet. Lihat Rate limit dan Billing.
Rotasi dan pencabutan
Untuk merotasi kunci, buat kunci pengganti, pasang di aplikasi Anda, lalu cabut kunci lama di konsol. Pencabutan berlaku seketika: request berikutnya dengan kunci lama gagal dengan 401. Riwayat pemakaian Anda tetap menyimpan nama dan prefix kunci yang sudah dicabut.