Memulai
Quickstart
Lakukan request API TokenLab pertama Anda dengan cURL, Python, JavaScript, Go, atau PHP. Siapkan API key Anda, konfigurasikan endpoint, dan verifikasi respons Chat Completions.
Mendapatkan API key
Buat akun
Daftar di tokenlab.sh menggunakan email, Google, atau akun GitHub Anda.
Buat dan simpan API key
Buka API Keys di workspace Anda. Buat kunci dan segera simpan nilai lengkapnya; kunci tersebut hanya ditampilkan satu kali. Jika Anda sudah menyimpan kunci lengkap, gunakan nilai tersebut. Awalan yang ditampilkan atau disalin dari daftar tidak dapat mengautentikasi request.
Periksa saldo workspace
Periksa saldo Anda di Billing. Akun baru mungkin mendapatkan kredit uji coba satu kali; jika tidak, saldo akan dimulai dari $0 dan memerlukan isi ulang (minimal $5) sebelum request pertama. Request akan ditagih sesuai harga model yang dipilih saat ini.
Jaga kerahasiaan API key. Jangan letakkan di kode sisi klien (client-side) atau repositori publik.
Mengatur kunci untuk terminal ini
Perintah di bawah ini menjaga kunci agar tidak muncul di dalam perintah itu sendiri. Perintah ini hanya mengaturnya untuk terminal saat ini dan proses turunannya. Gunakan secret manager untuk aplikasi yang dideploy.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYMenginstal klien
pip install openaiMengirim request pertama Anda
Untuk sebagian besar integrasi baru, mulailah dengan Chat Completions pada POST /v1/chat/completions.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'Simpan salah satu contoh SDK sebagai quickstart.py, quickstart.mjs, main.go, atau quickstart.php, lalu jalankan python quickstart.py, node quickstart.mjs, go run ., atau php quickstart.php. Python, JavaScript, dan Go menggunakan SDK OpenAI resmi; PHP menggunakan klien OpenAI PHP yang dikelola komunitas (PHP 8.2+).
Gunakan POST /v1/responses hanya jika Anda memerlukan perilaku khusus Responses. Dukungan untuk field khusus Responses bergantung pada model yang dipilih.
Mengonfirmasi hasil
Request yang berhasil akan mengembalikan jawaban yang tidak kosong. Buka Runs di workspace yang sama untuk memeriksa model, status, dan penggunaannya. Untuk error, ikuti troubleshooting. Mengubah model atau menambahkan streaming adalah langkah selanjutnya yang terpisah di panduan SDK.
Mengapa panggilan pertama saya mengembalikan 402?
Apakah panggilan pertama Anda berhasil atau tidak bergantung pada saldo yang ditampilkan di Billing. Saat penawaran kredit uji coba berjalan, akun baru yang memenuhi syarat mendapatkan $0,25 satu kali, untuk maksimal 10 panggilan dalam 7 hari; panggilan ke-11 akan mengembalikan 402 dan menyatakan bahwa panggilan uji coba gratis telah habis, meskipun masih ada sedikit kredit tersisa. Akun dengan saldo $0 akan mendapatkan HTTP 402 dengan kode error insufficient_balance. Isi ulang setidaknya $5 di Billing; $5 adalah isi ulang minimum. Kemudian kirim request yang sama lagi. Anda tidak memerlukan API key baru: kunci yang Anda buat akan terus berfungsi setelah saldo mencukupi untuk request tersebut.
Panggilan uji coba pertama biayanya sangat kecil. Satu contoh request ke deepseek-v4.1-flash biayanya jauh di bawah $0,01.
Jika Anda sudah memiliki saldo, pesan 402 akan memberi tahu berapa banyak yang dibutuhkan request tersebut dan berapa saldo Anda. TokenLab menahan biaya dari max_tokens penuh sebelum panggilan dimulai, jadi input yang panjang atau max_tokens yang besar mungkin memerlukan saldo yang lebih besar dari saldo kecil. Pada /v1/chat/completions dan /v1/messages, jika max_tokens yang lebih kecil dapat mencukupi, pesan tersebut juga akan memberikan nilai untuk menurunkannya. Jika biaya input saja lebih besar dari saldo Anda, pesan tersebut akan menyarankan untuk memperpendek input.
Kunci yang mencapai batas pengeluarannya sendiri juga akan mengembalikan 402, dengan kode quota_exceeded. Naikkan atau hapus batas tersebut di bawah API Keys. Untuk menangani 402 dalam kode, lihat penanganan error.