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.

OpsiJalurHargaJika jalur tidak tersedia
VerifiedHanya Verified: jalur yang diuji oleh TokenLabHarga Verified, lebih rendah dari harga Official pada sebagian besar modelPermintaan gagal dan tidak dikenakan biaya
OfficialHanya Official: pembuat model atau platform utamaHarga Official, harga yang dipublikasikan oleh pembuat modelPermintaan gagal dan tidak dikenakan biaya
Auto (default)Verified terlebih dahulu. Official menjalankan permintaan sekali jika Verified tidak memiliki pasokan atau gagal sebelum ada outputHarga jalur yang menyelesaikan permintaanOfficial 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-Policy akan 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 hargaContohPeriksa harga saat ini
Chat / Responsgpt-5.4, claude-sonnet-4-6, gemini-3.6-flashHalaman Models atau Pricing API
Embeddings / reranktext-embedding-3-small, qwen3-vl-rerankDetail harga model
Gambar berbasis tokengpt-image-2GET /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.

AlatModelBiaya
Pencarian webModel OpenAI, Claude dan Grok, serta model Gemini 3 dengan Google Search groundingSetiap pencarian yang dijalankan model. Untuk Gemini 3, setiap kueri pencarian unik
Search groundingModel Gemini 2.5 dengan Google Search groundingSekali 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 di measure.dimensions.webSearchCalls atau groundedPrompts, dan harga setiap panggilan di effectiveUnitPrices.webSearch atau effectiveUnitPrices.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, tambahkan cache_control ke blok tersebut sendiri.
BiayaDibandingkan 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 cacheLebih 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_tokens adalah jumlah token yang dibaca dari cache. usage.cache_creation_input_tokens adalah 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.

KeluargaContoh
Gambarflux-pro-1.1
Videoveo3.1, seedance-2.0
Musiksuno-music
3Dtripo-h3.1
Audiogrok-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.

Di halaman ini