Panduan inti
Penagihan dan harga
Cara kerja biaya, estimasi, saldo, dan batas
Satu saldo TokenLab dapat digunakan di berbagai model. Tidak ada biaya langganan atau pengeluaran minimum. Isi ulang saldo dimulai dari $5. Biaya didasarkan pada model dan penggunaan yang tercatat untuk setiap permintaan.
Opsi pengiriman
Model dan API yang sama tersedia melalui dua jalur: Verified lebih murah, dan Official lebih andal. Opsi pengiriman menentukan jalur mana yang menjalankan permintaan dan harga yang Anda bayar.
| Opsi | Jalur | Harga | Jika jalur tidak tersedia |
|---|---|---|---|
Verified | Hanya Verified: jalur yang diuji oleh TokenLab | Harga Verified, lebih rendah dari harga Official pada sebagian besar model | Permintaan gagal dan tidak dikenakan biaya |
Official | Hanya Official: pembuat model atau platform utama | Harga Official, harga yang dipublikasikan oleh pembuat model | Permintaan gagal dan tidak dikenakan biaya |
Auto (default) | Verified terlebih dahulu. Official menjalankan permintaan sekali jika Verified tidak memiliki pasokan atau gagal sebelum ada output | Harga jalur yang menyelesaikan permintaan | Official menjalankan permintaan |
Halaman Models menampilkan kedua harga untuk setiap model.
- Setiap permintaan yang selesai dikenakan biaya satu kali.
- Auto tidak berpindah setelah output dimulai atau setelah tugas diterima.
- Sebelum dijalankan, Auto menahan jumlah yang lebih tinggi dari dua kemungkinan jumlah tersebut. Jika saldo hanya mencakup estimasi Verified, Auto menjalankan Verified saja untuk permintaan tersebut dan tidak beralih ke Official. Setelah dijalankan, Anda membayar biaya aktual dan sisanya dikembalikan.
- Header permintaan
X-TokenLab-Delivery-Policyakan menggantikan pengaturan API key, dan pengaturan API key akan menggantikan default Workspace. Lihat pengantar API.
Untuk pembuatan berbayar, Console menampilkan estimasi maksimum sebelum konfirmasi. Setelah selesai, Runs dan Usage menampilkan biaya akhir dan opsi yang menyelesaikan permintaan tersebut.
Model Harga
Harga model dapat berubah. Periksa Console, halaman Models, GET /v1/models/:model/pricing, atau Pricing API untuk harga saat ini.
Pada halaman Models, tanda hubung di kolom harga atau diskon Verified berarti tidak ada penawaran Verified yang tersedia saat ini; ini tidak berarti gratis. Model dengan pasokan Official tetap tersedia melalui Official atau Auto. Di API, kolom harga Verified dari model tersebut bernilai null atau dihilangkan, dan kolom harga official_* menunjukkan apa yang Anda bayar. Label pengiriman menjelaskan opsi yang didukung, sementara ketersediaan diperiksa saat setiap permintaan dijalankan. Harga seri merangkum model dengan pasokan dalam opsi pengiriman yang relevan dan memisahkan unit penagihan yang berbeda.
Harga Berbasis Token
Sebagian besar model chat, penalaran, embedding, rerank, dan beberapa model gambar diberi harga berdasarkan token input, output, cache, atau output gambar.
| Keluarga harga | Contoh | Periksa harga saat ini |
|---|---|---|
| Chat / Respons | gpt-5.4, claude-sonnet-4-6, gemini-3.6-flash | Halaman Models atau Pricing API |
| Embeddings / rerank | text-embedding-3-small, qwen3-vl-rerank | Detail harga model |
| Gambar berbasis token | gpt-image-2 | GET /v1/models/gpt-image-2/pricing |
Jangan melakukan hard-code pada tabel harga yang disalin. Baca harga saat ini ketika aplikasi Anda perlu menampilkan atau membandingkan biaya.
Biaya alat (Tool fees)
Beberapa alat bawaan memerlukan biaya tambahan di luar token. TokenLab mengenakan biaya alat hanya ketika model menggunakan alat tersebut dan respons melaporkannya. Permintaan yang menawarkan alat tetapi tidak digunakan oleh model tidak dikenakan biaya alat.
| Alat | Model | Biaya |
|---|---|---|
| Pencarian web | Model OpenAI, Claude dan Grok, serta model Gemini 3 dengan Google Search grounding | Setiap pencarian yang dijalankan model. Untuk Gemini 3, setiap kueri pencarian unik |
| Search grounding | Model Gemini 2.5 dengan Google Search grounding | Sekali untuk setiap permintaan yang menggunakan search grounding |
- Setiap model memiliki biaya alat sendiri untuk Verified dan Official, sama seperti harga tokennya. Detail harga model menampilkannya sebagai Web search atau Search grounding.
- Hasil pencarian yang dibaca oleh model ditagih sebagai token input sesuai harga model.
- Alat tanpa harga pada suatu model tidak dikenakan biaya.
- Di Console, buka permintaan di Runs: Tool fees menampilkan jumlah panggilan dan harga setiap panggilan. Catatan penggunaan API key menampilkan nilai yang sama di
charged_price_basis: jumlah dimeasure.dimensions.webSearchCallsataugroundedPrompts, dan harga setiap panggilan dieffectiveUnitPrices.webSearchataueffectiveUnitPrices.groundedPrompt.
Prompt caching
Model dapat membaca awal prompt yang berulang dari cache. Token yang dibaca dari cache lebih murah daripada token input.
- Model GPT, Gemini, dan beberapa model lainnya melakukan cache pada prompt panjang yang berulang secara otomatis. Anda tidak perlu mengatur apa pun.
- Model Claude melakukan cache hanya jika Anda memintanya. Kirim
"anthropic_options": {"prompt_caching": true}dalam permintaan Chat Completions. TokenLab menandai akhir dari system prompt dan pesan pengguna terbaru sebagai titik cache. Dengan Messages API, tambahkancache_controlke blok tersebut sendiri.
| Biaya | Dibandingkan dengan harga input |
|---|---|
| Penulisan cache, 5 menit (default) | Lebih tinggi |
Penulisan cache, 1 jam ("prompt_caching_ttl": "1h") | Lebih tinggi dari penulisan 5 menit |
| Pembacaan cache | Lebih rendah |
- Harga cache berbeda berdasarkan model dan opsi pengiriman. Periksa harga cache model di halaman Models atau di Pricing API sebelum Anda mengandalkan rasio.
- Prompt yang tidak pernah berulang sedikit lebih mahal dengan caching aktif, karena adanya penulisan cache.
- Prompt yang lebih pendek dari panjang minimum cacheable model tidak di-cache dan tidak dikenakan biaya penulisan cache.
- Cache satu jam tidak tersedia di setiap model. Jika model tidak mencantumkannya, gunakan cache lima menit.
- Respons menampilkan hasilnya:
usage.prompt_tokens_details.cached_tokensadalah jumlah token yang dibaca dari cache.usage.cache_creation_input_tokensadalah jumlah yang ditulis ke dalamnya, dan hanya muncul jika nilainya lebih dari nol.
Tingkat layanan (Service tier)
TokenLab menjalankan dan menagih permintaan pada tingkat layanan standar. Nilai service_tier yaitu auto dan default diterima. Nilai lain, seperti flex, priority, fast, dan ultrafast, diabaikan: permintaan dijalankan pada tingkat standar dan dikenakan harga standar.
Harga Permintaan dan Tugas
Model gambar, video, musik, 3D, audio, dan dunia mungkin diberi harga per permintaan, gambar, detik, menit, atau tugas. Halaman model menampilkan unit penagihan.
| Keluarga | Contoh |
|---|---|
| Gambar | flux-pro-1.1 |
| Video | veo3.1, seedance-2.0 |
| Musik | suno-music |
| 3D | tripo-h3.1 |
| Audio | grok-tts, whisper-large-v3 |
Penagihan tugas asinkron
Beberapa tugas mencadangkan estimasi biaya saat dibuat. Tugas yang selesai ditagih satu kali; tugas yang gagal akan melepaskan atau mengembalikan jumlah yang tertunda.
Pembuatan gambar, video, musik, 3D, dan tugas berbasis tugas mengembalikan ID tugas dan poll_url. Jumlah akhir dicatat setelah tugas menjadi completed atau failed. Tugas yang selesai menyertakan billing_transaction_id setelah penagihan; tugas yang gagal tidak dikenakan biaya.
Jika Usage masih belum menampilkan biaya akhir atau jumlah yang dilepaskan setelah tugas selesai, hubungi hello@tokenlab.sh dengan menyertakan Request ID dan ID tugas.
ID transaksi penagihan
Respons yang kompatibel dengan OpenAI non-streaming menyertakan billing_transaction_id ketika penagihan selesai sebelum respons dikirim. Nilai yang sama mungkin muncul di X-Billing-Transaction-ID; format Gemini dan format asli lainnya mungkin hanya mengeksposnya di header ini.
Tugas asinkron menyertakan billing_transaction_id setelah selesai. Streaming mungkin selesai sebelum penagihan, jadi gunakan Usage jika header tidak ada.
Jumlah token
Model teks biasanya melaporkan token input, output, dan total di usage. Tokenisasi berbeda berdasarkan model, bahasa, dan input media, sehingga rumus hitung karakter tidak dapat diandalkan sebagai estimasi penagihan. Gunakan harga model saat ini dan catatan Usage akhir.
Menemukan penggunaan Anda
Buka Usage untuk menemukan:
- Saldo real-time
- Riwayat penggunaan berdasarkan model
- Rincian biaya
- Penggunaan API key
Respons API
Respons berbasis token biasanya menyertakan informasi penggunaan:
{
"usage": {
"prompt_tokens": 50,
"completion_tokens": 100,
"total_tokens": 150
}
}Menghemat pengeluaran
Peringatan saldo rendah
Atur ambang batas di Console → Settings. TokenLab akan mengirim email kepada Anda saat saldo turun di bawah ambang batas tersebut.
Menambah saldo
Buka Console → Billing, pilih jumlah, dan gunakan salah satu metode pembayaran yang ditampilkan saat checkout. Saldo diperbarui setelah penyedia pembayaran mengonfirmasi pembayaran.
Selama penawaran kredit percobaan berlangsung, akun baru yang memenuhi syarat mendapatkan kredit percobaan $0.25 satu kali untuk maksimal 10 panggilan. Kredit percobaan yang tidak terpakai akan kedaluwarsa setelah 7 hari.
Agar permintaan tidak berhenti saat saldo rendah, aktifkan Automatic funding di Billing. Fitur ini akan menambah dana saat saldo turun di bawah jumlah yang Anda tetapkan, hingga batas bulanan.
Batas API Key
Anda dapat menetapkan batas pengeluaran saat membuat atau mengedit API key di Console → API Keys.
Ketika batas tercapai, permintaan dengan kunci tersebut akan mengembalikan 402 dengan kode quota_exceeded. Naikkan atau hapus batas untuk melanjutkan.
Bantuan penagihan
Hubungi hello@tokenlab.sh untuk pertanyaan seputar penagihan.