Memulai
Autentikasi
Amankan permintaan API TokenLab Anda dengan API key
API Key
Panggilan model dan sumber daya privat memerlukan kunci API. Endpoint publik seperti GET /v1/models dan GET /v1/models/{model} dapat digunakan tanpa kunci. Keberhasilan kueri penemuan tidak membuktikan kunci dapat digunakan; ikuti panduan mulai cepat untuk mengirim permintaan model. Gunakan kunci lengkap yang disimpan, bukan awalan dalam daftar.
Untuk endpoint yang kompatibel dengan OpenAI, kirim 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 tersendiri:
Authorization: Bearer mt-your-management-tokenGunakan token manajemen hanya untuk /v1/management/*. Buka API → Tokens pada workspace yang dipilih untuk membuat atau mengganti token. Simpan token lengkap dengan aman saat ditampilkan; token hanya ditampilkan sekali setelah dibuat atau diganti.
Token manajemen tidak dapat digunakan untuk inferensi model, dan API key biasa sk-... tidak dapat digunakan untuk API manajemen.
Mendapatkan API Key Anda
- Masuk ke TokenLab Dashboard Anda
- Buka API Keys
- Buat key baru
- Beri nama yang deskriptif
- Salin segera karena hanya ditampilkan satu kali
- Jangan pernah mengekspos API key dalam kode sisi klien
- Jangan pernah melakukan commit API key ke version control
- Gunakan environment variables atau secret manager
- Rotasi key secara berkala
- Hapus key yang tidak digunakan
Menggunakan API Key
Lihat panduan mulai cepat untuk variabel lingkungan dan permintaan pertama yang lengkap. Gunakan SDK sesuai format API dan simpan kunci di server.
Fitur API Key
Batas Penggunaan
Anda dapat menetapkan batas penggunaan pada setiap API key:
| Pengaturan | Deskripsi |
|---|---|
| No Limit | Key menggunakan saldo akun Anda tanpa batasan |
| Fixed Limit | Key berhenti berfungsi setelah mencapai jumlah yang ditentukan |
Prefix Key
Semua API key TokenLab diawali dengan sk-.
Respons Error
| Kode Status | Tipe | Kode | Deskripsi |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | Kunci API tidak ada, tidak valid, tidak aktif, atau telah dicabut |
| 401 | expired_api_key | expired_api_key | Kunci API telah kedaluwarsa |
| 402 | insufficient_balance | insufficient_balance | Saldo akun tidak mencukupi |
| 402 | quota_exceeded | quota_exceeded | Batas penggunaan API key tercapai |
Contoh:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}