Memulai
Autentikasi
Autentikasi permintaan API TokenLab dengan API key
API Keys
Pemanggilan model dan sumber daya privat memerlukan API key. Endpoint penemuan publik seperti GET /v1/models dan GET /v1/models/{model} dapat berfungsi tanpa API key. Respons penemuan yang berhasil tidak memverifikasi bahwa key Anda berfungsi; ikuti Quickstart untuk mengirim permintaan model. Gunakan key lengkap yang telah disimpan; prefiks dalam daftar key 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-keyPermintaan /v1beta/* yang kompatibel dengan Gemini juga menerima x-goog-api-key: sk-your-api-key. Lebih disarankan menggunakan header daripada parameter kueri ?key=, karena URL sering kali tersimpan dalam log.
Management Tokens
Endpoint Management API menggunakan jenis token yang terpisah:
Authorization: Bearer mt-your-management-tokenGunakan management token hanya dengan endpoint /v1/management/*. Buka API → Tokens untuk workspace yang dipilih guna membuat atau mengganti token. Simpan token lengkap saat ditampilkan; token hanya ditampilkan satu kali setelah pembuatan atau penggantian.
Management tokens tidak dapat digunakan untuk inferensi model, dan API key standar sk-... tidak dapat digunakan untuk Management API.
Mendapatkan API key
- Masuk ke TokenLab Console
- Buka API Keys
- Buat key baru
- Berikan nama yang deskriptif
- Salin segera karena key hanya ditampilkan satu kali
- Jangan pernah mengekspos API key dalam kode sisi klien (client-side)
- Jangan pernah melakukan commit API key ke kontrol versi
- Gunakan variabel lingkungan atau secret manager
- Lakukan rotasi key secara berkala
- Hapus key yang tidak digunakan
Menggunakan API key
Lihat Panduan Cepat untuk variabel lingkungan dan permintaan pertama yang lengkap. Gunakan SDK yang sesuai dengan format API pilihan Anda; simpan key di server.
Pengaturan Key
Anda dapat mengatur hal-hal berikut pada setiap API key di Console, dan melalui API Manajemen:
| Pengaturan | Deskripsi |
|---|---|
| Spending limit | No limit memungkinkan key menggunakan saldo Workspace. Fixed limit membuat key mengembalikan 402 quota_exceeded setelah mencapai jumlah tersebut. |
| Allowed models | Key hanya dapat memanggil model-model ini. Model lain akan mengembalikan 403 model_not_allowed. Kosong berarti tidak ada batasan di tingkat key. |
| Delivery option | Auto, Verified, atau Official untuk permintaan dari key ini. Kosong berarti menggunakan default Workspace. Lihat Penagihan dan harga. |
| Expiration | Setelah waktu ini, key akan mengembalikan 401 expired_api_key. |
| Status | Key dengan status inactive (dijeda) akan mengembalikan 401 invalid_api_key. Key yang revoked tidak dapat diaktifkan kembali. |
Prefiks Key
Semua API key TokenLab dimulai dengan sk-.
Respons Error
| Kode Status | Tipe | Kode | Deskripsi |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | API key tidak ada, tidak valid, tidak aktif, atau dicabut |
| 401 | expired_api_key | expired_api_key | Key telah kedaluwarsa |
| 402 | insufficient_balance | insufficient_balance | Saldo akun tidak mencukupi |
| 402 | quota_exceeded | quota_exceeded | Batas penggunaan API key tercapai |
| 403 | permission_error | model_not_allowed | Key tidak diizinkan untuk menggunakan model yang diminta |
| 403 | permission_error | user_suspended, account_restricted | Akun tidak dapat menggunakan API |
| 429 | rate_limit_exceeded | rate_limit_exceeded | Terlalu banyak percobaan autentikasi gagal dari satu alamat IP. Tunggu Retry-After dan perbaiki key; jangan melakukan loop pada 401 |
Contoh:
{
"error": {
"message": "Invalid API key",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}