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-key

Untuk permintaan /v1/messages yang kompatibel dengan Anthropic, Anda juga dapat menggunakan:

x-api-key: sk-your-api-key

Permintaan /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-token

Gunakan 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

  1. Masuk ke TokenLab Console
  2. Buka API Keys
  3. Buat key baru
  4. Berikan nama yang deskriptif
  5. 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:

PengaturanDeskripsi
Spending limitNo limit memungkinkan key menggunakan saldo Workspace. Fixed limit membuat key mengembalikan 402 quota_exceeded setelah mencapai jumlah tersebut.
Allowed modelsKey hanya dapat memanggil model-model ini. Model lain akan mengembalikan 403 model_not_allowed. Kosong berarti tidak ada batasan di tingkat key.
Delivery optionAuto, Verified, atau Official untuk permintaan dari key ini. Kosong berarti menggunakan default Workspace. Lihat Penagihan dan harga.
ExpirationSetelah waktu ini, key akan mengembalikan 401 expired_api_key.
StatusKey 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 StatusTipeKodeDeskripsi
401invalid_api_keyinvalid_api_keyAPI key tidak ada, tidak valid, tidak aktif, atau dicabut
401expired_api_keyexpired_api_keyKey telah kedaluwarsa
402insufficient_balanceinsufficient_balanceSaldo akun tidak mencukupi
402quota_exceededquota_exceededBatas penggunaan API key tercapai
403permission_errormodel_not_allowedKey tidak diizinkan untuk menggunakan model yang diminta
403permission_erroruser_suspended, account_restrictedAkun tidak dapat menggunakan API
429rate_limit_exceededrate_limit_exceededTerlalu 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"
  }
}

Di halaman ini