Billing

Organisasi Anda punya satu wallet prabayar dalam dolar AS. Anda mengisinya lewat top-up QRIS dalam Rupiah, dan setiap request API ditagihkan ke wallet itu per token. Tidak ada langganan dan tidak ada biaya bulanan.

Harga

Harga bersifat tetap: tidak berubah menurut jam atau kurs. Setiap request ditagih berdasarkan pemakaian yang dilaporkan penyedia model di respons:

biaya = prompt_cache_hit_tokens  × $0.010 / 1.000.000
      + prompt_cache_miss_tokens × $0.400 / 1.000.000
      + completion_tokens        × $1.600 / 1.000.000

Biaya dihitung hingga sepermiliar dolar, dibulatkan ke atas, dan ditampilkan hingga enam angka desimal ($0.000001) di konsol.

Contoh perhitungan

Sebuah chatbot support mengirim prompt berisi 12.400 token. System prompt dan giliran sebelumnya baru saja dipakai, jadi 8.000 token merupakan cache hit dan 4.400 token cache miss. Model menulis 1.800 token output, termasuk reasoning.

Seribu request seperti ini berbiaya $4.72. Tanpa cache, seluruh 12.400 token input akan ditagih $0.400 per 1M, dan setiap request berbiaya $0.007840 — di sini cache menghemat sekitar 40%.

Harga cache

Penyedia menyimpan cache untuk awalan prompt secara otomatis; Anda tidak perlu mengaktifkan apa pun. Jika awal sebuah prompt sama dengan request yang baru saja dikirim, token tersebut ditagih dengan harga cache hit. Supaya hemat:

• Letakkan konten yang tetap di awal: system prompt, definisi tool, dokumen referensi.
• Letakkan bagian yang berubah — pesan user terbaru — di akhir.
• Jaga awalan yang tetap identik byte demi byte di setiap request.

usage.prompt_cache_hit_tokens dan usage.prompt_cache_miss_tokens di setiap respons menunjukkan pembagian prompt secara persis.

Hold

Sebelum request dikirim ke model, Laras Router menahan sebagian saldo wallet Anda sebagai hold: jumlah yang dicadangkan untuk request itu, supaya request yang berjalan bersamaan tidak pernah memakai uang yang sama dua kali. Setelah request selesai, hold diselesaikan sesuai biaya sebenarnya dan sisanya langsung dilepas.

Besar hold disesuaikan dengan biaya terbesar yang mungkin terjadi — prompt terbesar yang diterima model dengan harga cache miss, ditambah batas output Anda dengan harga output. Dengan batas default 8.192 token output, nilainya sekitar $0.41. Dengan max_tokens 384.000, sekitar $0.86. Anda hanya ditagih sesuai pemakaian sebenarnya; hold hanya mencadangkan ruang.

Saldo tersedia Anda adalah saldo dikurangi hold dari request yang masih berjalan.

Overdraft

Request diterima selama saldo tersedia Anda di atas $0.00, meskipun lebih kecil dari hold request tersebut. Saat request itu diselesaikan, biayanya bisa membuat saldo Anda minus — paling banyak $1.00. Jumlah minus itu dipotong dari top-up Anda berikutnya.

Selama saldo tersedia Anda $0.00 atau kurang, request baru gagal dengan 402 insufficient_credit sampai Anda mengisi saldo.

Dengan begitu Anda bisa memakai seluruh saldo tanpa menyisakan beberapa sen yang tidak terpakai. Artinya juga, dengan saldo kecil, satu request yang sedang berjalan bisa menahan seluruh saldo: request lain ditolak sampai request itu selesai.

Anggaran kunci

Setiap API key bisa punya anggaran bulanan opsional dalam USD, yang diatur di konsol. Anggaran melindungi wallet Anda dari satu environment yang lepas kendali atau kunci yang bocor.

• Pengeluaran bulan berjalan sebuah kunci adalah tagihan yang sudah diselesaikan ditambah hold dari request-nya yang masih berjalan.
• Bulan dihitung per bulan kalender menurut waktu Jakarta (WIB, UTC+7).
• Request yang hold-nya akan membuat kunci melampaui anggaran gagal dengan 402 key_budget_exceeded sebelum sampai ke model, dan tidak ada yang ditagih.
• Karena hold ikut dihitung, kunci bisa ditolak sedikit sebelum anggarannya benar-benar habis. Misalnya, jika $9.70 dari anggaran $10.00 sudah terpakai, request dengan hold $0.41 akan ditolak.
• Anggaran hanya membatasi satu kunci. Anggaran tidak pernah membuat kunci bisa memakai lebih dari saldo wallet Anda.

Request yang gagal

• Request yang ditolak Laras Router (kunci salah, wallet kosong, rate limit, body tidak valid) tidak pernah ditagih.
• Request yang ditolak penyedia model dengan error 4xx tidak ditagih; hold-nya dilepas.
• Request yang gagal dengan 5xx, timeout, atau terputus tetap ditahan hold-nya selama kami melakukan rekonsiliasi dengan penyedia. Anda hanya ditagih untuk pemakaian yang dilaporkan penyedia; jika tidak ada, hold dilepas tanpa biaya.

Email saldo menipis

Saat saldo tersedia Anda turun di bawah $1.00, pemilik dan admin organisasi Anda menerima satu email berisi tautan untuk mengisi saldo. Peringatan berikutnya baru dikirim setelah saldo kembali di atas $1.00 lalu turun lagi.

Tempat melihat tagihan

Konsol menampilkan saldo Anda, setiap top-up dan tagihan di riwayat wallet, serta setiap request di menu Usage lengkap dengan rincian token dan biaya pastinya. Sertakan nilai header X-Laras-Request-ID saat Anda bertanya kepada support soal tagihan tertentu.