Memulai
Autentikasi
Autentikasi permintaan API TokenLab dengan kunci API
Kunci API
Panggilan model dan sumber daya privat memerlukan kunci API. Endpoint penemuan publik seperti GET /v1/models dan GET /v1/models/{model} dapat berfungsi tanpa kunci. Respons penemuan yang berhasil tidak memverifikasi bahwa kunci Anda berfungsi; ikuti Panduan Memulai (Quickstart) untuk mengirim permintaan model. Gunakan kunci lengkap yang disimpan; prefiks dalam daftar kunci tidak dapat digunakan untuk autentikasi.
Untuk endpoint yang kompatibel dengan OpenAI, kirimkan sebagai:
Authorization: Bearer sk-your-api-keyUntuk permintaan /v1/messages yang kompatibel dengan Anthropic, Anda juga dapat menggunakan:
x-api-key: sk-your-api-keyToken Manajemen
Endpoint API Manajemen menggunakan jenis token yang terpisah:
Authorization: Bearer mt-your-management-tokenGunakan token manajemen hanya dengan endpoint /v1/management/*. Buka API → Tokens untuk ruang kerja yang dipilih guna membuat atau mengganti token. Simpan token lengkap saat ditampilkan; token hanya ditampilkan sekali setelah pembuatan atau penggantian.
Token manajemen tidak dapat digunakan untuk inferensi model, dan kunci API sk-... standar tidak dapat digunakan untuk API Manajemen.
Mendapatkan kunci API
- Masuk ke Konsol TokenLab
- Buka API Keys
- Buat kunci baru
- Berikan nama yang deskriptif
- Salin segera karena kunci hanya ditampilkan sekali
- Jangan pernah mengekspos kunci API dalam kode sisi klien (client-side)
- Jangan pernah melakukan commit kunci API ke kontrol versi
- Gunakan variabel lingkungan atau manajer rahasia (secret manager)
- Rotasi kunci secara berkala
- Hapus kunci yang tidak digunakan
Menggunakan kunci API
Lihat Panduan Cepat untuk variabel lingkungan dan permintaan pertama yang lengkap. Gunakan SDK yang sesuai dengan format API pilihan Anda; simpan kunci di server.
Mengatur batas penggunaan
Anda dapat mengatur batas penggunaan pada setiap kunci API:
| Pengaturan | Deskripsi |
|---|---|
| No Limit | Kunci menggunakan saldo akun Anda tanpa batasan |
| Fixed Limit | Kunci berhenti berfungsi setelah mencapai jumlah yang ditentukan |
Prefiks kunci
Semua kunci API TokenLab dimulai dengan sk-.
Respons Kesalahan
| Kode Status | Tipe | Kode | Deskripsi |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | Kunci API hilang, tidak valid, tidak aktif, atau dicabut |
| 401 | expired_api_key | expired_api_key | Kunci telah kedaluwarsa |
| 402 | insufficient_balance | insufficient_balance | Saldo akun tidak mencukupi |
| 402 | quota_exceeded | quota_exceeded | Batas penggunaan kunci API tercapai |
Contoh:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}