API keys

Membuat, membatasi, merotasi, dan mencabut key — serta efek nyata dari grup.

Membuat key

Dashboard → API Keys → Create key

Field	Saran
Name	Nama yang mudah dicari: prod-backend, laptop-cursor
Group	Menentukan pool upstream dan pengali harga. Pilih sesuai paket Anda
Quota	Batas untuk key ini; berguna untuk aplikasi klien dan CI
Expiry	Isi untuk akses sementara
Allowed models	Batasi key ke model tertentu; kosong berarti default grup

Secret ditampilkan setelah pembuatan dan tetap bisa dilihat di console. Perlakukan sesi console dan secret sama-sama sebagai kredensial.

Fungsi grup

Grup adalah profil routing dan harga yang ditentukan operator. Dua key di satu akun bisa memakai grup berbeda, sehingga model dan harga yang terlihat juga berbeda.

• Model per grup: panggil GET /v1/models dengan key tersebut.
• Harga per grup: halaman pricing.
• Jika muncul model_not_found, modelnya ada tapi tidak untuk grup key itu — ini penyebab paling umum.

Kuota key vs saldo akun

Dua-duanya berlaku dan independen:

request diterima  =  kuota key masih ada  DAN  saldo akun > 0

Menyetel Quota pada key tidak menambah saldo. Jika terlalu kecil, hasilnya insufficient_user_quota walaupun akun masih punya dana.

Rotasi dan pencabutan

1. Buat key pengganti dengan grup dan limit yang sama.
2. Deploy ke aplikasi.
3. Nonaktifkan key lama di console (atau hapus).

Penonaktifan langsung berlaku untuk request baru. Request yang sedang streaming tetap selesai.

Penyimpanan key di kode

Environment variable

export TRIW_API_KEY="sk-..."

Jangan menyertakan key di bundle frontend. Untuk klien browser, proxy lewat backend Anda dan simpan key di sisi server.