Dokumentasi
Penagihan
Bayar sesuai pemakaian dari dompet prabayar. Setiap panggilan diukur hingga satuan mikrosen dan dicatat dalam buku besar yang tidak dapat diubah. Tanpa langganan dan tanpa komitmen; saldo tidak pernah kedaluwarsa.
Isi saldo melalui Stripe → saldo tersimpan di dompet Anda → biaya setiap panggilan API dipotong secara langsung. Jika saldo Anda habis, panggilan akan mengembalikan 402 insufficient_quota hingga Anda mengisi saldo lagi.
Untuk membaca saldo secara terprogram, panggil GET /v1/balance. Endpoint ini mengembalikan saldo dompet, jumlah yang ditahan untuk tugas yang masih berjalan, dan sisa batas bulanan; pemanggilannya tidak dikenai biaya. Lihat Saldo.
Model harga
Untuk setiap panggilan, Kunavo menghitung biaya pengguna dengan memilih angka yang lebih besar dari dua angka berikut:
- Biaya katalog — harga yang ditampilkan pada kartu model (per 1 juta token, per gambar, per detik video, dan sebagainya) × unit penggunaan aktual.
- Biaya upstream — biaya yang dikenakan penyedia kepada Kunavo untuk panggilan tersebut.
- Faktor markup — margin Kunavo atas biaya tersebut.
Penggunaan max() memastikan: (a) Anda tidak pernah membayar kurang dari harga katalog yang diiklankan, dan (b) kami tidak pernah rugi pada panggilan yang biaya upstream-nya tiba-tiba melonjak.
Unit penagihan menurut modalitas
| Modalitas | Satuan | Granularitas |
|---|---|---|
| Obrolan | per 1 juta token input + per 1 juta token output | Tepat per token; token penalaran ditagihkan dengan tarif output. |
| Gambar (t2i / edit) | per gambar | Per gambar yang dihasilkan; pembuatan gambar yang hanya selesai sebagian tidak dikenai biaya. |
| Video | per video | Harga tetap per klip, ditentukan berdasarkan tingkat resolusi. |
Prompt panjang ditagihkan dengan tarif vendor untuk konteks panjang. Pada GPT-5.5, GPT-5.6 Sol dan Terra, serta GPT-6 Astra, prompt yang melebihi 272K token input membuat seluruh permintaan ditagihkan sebesar 2× untuk input — termasuk pembacaan dan penulisan cache — dan sebesar 1.5× untuk output, sesuai tingkat harga yang dipublikasikan OpenAI. Claude tidak mengenakan biaya tambahan untuk konteks panjang: konteks 1 jutanya ditagihkan dengan tarif standar.
Token yang di-cache
Model chat menyimpan prefiks prompt yang stabil di cache. Pembacaan cache ditagihkan jauh di bawah tarif input normal — 0.10× untuk Claude maupun OpenAI, dan 0.025× di Claude Fable 5.1, 0.05× di Claude Opus 5.5. Penulisan cache ditagihkan sebesar 1.25× tarif input pada setiap model Claude, termasuk penulisan dengan TTL 1 jam (di bawah 2× milik Anthropic), serta pada GPT-5.6 Sol, Terra dan Luna, serta GPT-6 Astra; pada semua model lainnya, penulisan ditagihkan dengan tarif input biasa. Setiap kelas memiliki diskon khusus modelnya sendiri, sehingga harga cache mendapat diskon yang sama dari daftar harga vendor seperti harga input dan output model tersebut. Batas minimum max() di atas dihitung dengan memperhitungkan cache, sehingga diskonnya diteruskan kepada Anda alih-alih terhapus oleh harga katalog.
Lihat panduan penyimpanan prompt dalam cache untuk tabel harga lengkap, cara mengaktifkan cache_control, dan cara perutean afinitas Kunavo menjaga cache tetap hangat.
Presisi
Semua nilai di Kunavo disimpan dalam micro_cents:
1 USD = 100,000,000 micro_cents1 cent = 1,000,000 micro_cents- Biaya minimum yang dapat dihitung:
0.0001 cent($0.000001). Panggilan chat dalam penggunaan nyata sering ditagihkan sebesar nilai minimum ini.
Tampilan dasbor membulatkan nilai kecil hingga 6 angka desimal (USD), dan hingga 2 angka desimal setelah nilainya mencapai satuan sen. Pembukuan internal menggunakan nilai yang eksak.
Isi saldo
Isi saldo Anda di /app/billing melalui Stripe Checkout: kartu (Visa, Mastercard, Amex, JCB, UnionPay) di semua tempat yang dijangkau Stripe, serta Apple Pay, Google Pay, dan Link di semua tempat kecuali India. Metode pembayaran yang dibatasi negara muncul untuk pasar pembeli sendiri — di Amerika Serikat Cash App Pay, Klarna, Afterpay, debit bank ACH (diselesaikan dalam 3–5 hari kerja), dan kripto (stablecoin), ditambah Affirm untuk pengisian sebesar $100 atau lebih, serta Zip untuk pengisian sebesar $100 hingga $1.500; Alipay dan WeChat Pay untuk China daratan; KakaoPay, Naver Pay, PAYCO, Samsung Pay, dan kartu domestik Korea Selatan di Korea Selatan; UPI di India; Pix di Brasil; iDEAL di Belanda, Bancontact di Belgia, EPS di Austria, MB WAY di Portugal, dan Satispay di Italia; BLIK di Polandia; Bacs Direct Debit di Britania Raya; serta Pay by Bank untuk pembeli di Britania Raya, Irlandia, dan Finlandia.
Harga bertingkat
| Isi saldo | Yang Anda dapatkan | Bonus |
|---|---|---|
| $10 | $10.00 | — |
| $100 | $110.00 | +$10 (10%) |
| $1.000 | $1.200,00 | +$200 (20%) |
| $5.000 | $6.250,00 | +$1.250 (25%) |
/app/keys untuk menetapkan batas tegas bagi beban kerja tertentu: jika pengeluaran kunci tersebut pada bulan kalender berjalan akan melampaui angka yang Anda tetapkan, panggilannya akan ditolak dengan 402 insufficient_quota dan tidak dikenai biaya. Kunci Anda yang lain tetap berfungsi. Layar yang sama juga menyediakan daftar izin IP per kunci — panggilan dari alamat lain akan menerima 403.Isi saldo otomatis
Opsional. Simpan kartu sekali melalui /app/billing lalu tetapkan tiga angka: ambang saldo yang memicu isi saldo ketika saldo turun di bawahnya, jumlah yang ditambahkan setiap kali, dan batas bulanan. Setelah itu, Kunavo mengisi dompet dari kartu tersebut dalam hitungan detik setelah sebuah tagihan membuat saldo berada di bawah ambang, dan juga ketika saldo dompet tidak dapat menutupi sebuah permintaan; dalam hal itu, Kunavo mencoba permintaan tersebut sekali lagi sebelum memberikan respons. Pengisian hanya dilakukan jika saldo (sebelum dikurangi jumlah yang ditahan untuk permintaan dan tugas yang sedang berjalan) berada di bawah ambang dan batasan pengisian mengizinkannya; jika pengisian tidak dilakukan atau tidak mencukupi, permintaan ditolak, sehingga 402 tetap bisa muncul meskipun isi saldo otomatis aktif.
| Pengaturan | Rentang | Catatan |
|---|---|---|
| Pemicu saat saldo di bawah | $5 – $1.000 | Tetapkan di atas nilai permintaan tunggal terbesar Anda. |
| Jumlah setiap kali | $10 – $1.000, dalam bilangan bulat dolar | $100 dan $1.000 menerima bonus yang sama seperti pengisian manual, dan beberapa jumlah yang lebih kecil menerima bonus kecil tersendiri; jumlah lainnya tidak menerima bonus. |
| Batas bulanan | jumlah – $20.000 | Menghitung jumlah yang ditagihkan setiap bulan kalender, tidak termasuk bonus. |
KUNAVO* AUTOTOPUP.Selama proses isi saldo berlangsung, permintaan yang ditolak akan menerima 402 dengan Retry-After: 3; setiap penolakan lainnya menjelaskan tindakan selanjutnya. Anda dapat menonaktifkannya atau mengubah angkanya kapan saja di halaman yang sama.
Waktu webhook
Setelah Anda menyelesaikan Stripe Checkout, saldo diperbarui melalui webhook. Webhook biasanya terpicu dalam 5–10 detik setelah pembayaran dikonfirmasi. Pembayaran dengan kartu hampir seketika; metode yang hanya dikonfirmasi secara asinkron dapat memerlukan waktu beberapa hari untuk diselesaikan. Pesanan tersebut berstatus processing hingga dana diterima, lalu webhook penyelesaian akan mengisi saldo dompet — Anda tidak perlu membayar lagi dan tidak ada yang kedaluwarsa selama Anda menunggu. Pesanan yang tidak pernah diselesaikan akan berstatus pending, lalu tugas pembersihan kami mengubah labelnya menjadi expired setelah 24 jam; label tersebut hanya bersifat kosmetik dan tidak membatalkan apa pun.
Buku besar kredit
Setiap perubahan saldo dicatat dalam buku besar yang hanya bisa ditambahkan:
| Tipe | Arah | Kapan |
|---|---|---|
| topup | kredit (+) | Pembayaran Stripe dikonfirmasi. |
| consume | debit (−) | Panggilan API ditagihkan setelah selesai. |
| refund | debit (−) | Saldo berbayar dikembalikan ke metode pembayaran Anda, dan bonus dari pengisian saldo tersebut ikut dipotong dari dompet. |
| manual_ | kredit (+/−) | Koreksi manual oleh tim operasional (misalnya, kredit setelah insiden). |
Setiap baris diberi cap balance_after_micro_cents, yang memberikan gambaran saldo pada setiap peristiwa. Lihat riwayat lengkap di /app/billing.
Log penggunaan
Setiap panggilan API menghasilkan satu baris di usage_logs:
- Model, status (berhasil / error), kode status HTTP
- Token input / output, token cache + penulisan cache, jumlah gambar, detik, karakter
cost_micro_cents— biaya yang Anda bayar- Latensi, IP permintaan, user agent, prefiks kunci API
Dapat dilihat di /app/usage dengan filter dan halaman detail per panggilan.
Panggilan yang gagal — apakah tetap dikenai biaya?
Tidak. Kunavo hanya menagih untuk status = success. Jika penyedia hulu mengembalikan 4xx / 5xx, atau tugas kami mengalami timeout, panggilan tetap dicatat tetapi biayanya $0. Kami menanggung sendiri biaya penyedia hulu, bukan meneruskannya kepada Anda.
Pengembalian dana
Saldo yang belum digunakan dan telah Anda bayar dapat dikembalikan kapan saja, tanpa perlu menutup akun Anda, ke metode pembayaran yang Anda gunakan, setelah dikurangi biaya pemrosesan Stripe secara proporsional dengan jumlah yang dikembalikan. Saldo yang sudah digunakan untuk panggilan API, serta kredit bonus atau promosi, tidak dapat dikembalikan.
Ajukan pengembalian dana di halaman Penagihan → Kembalikan saldo yang belum terpakai, atau melalui email ke contact@kunavo.com. Permintaan diproses dalam 5 hari kerja. Jika batas waktu pengembalian dana untuk metode pembayaran lokal telah lewat, bagian pengembalian dana untuk metode tersebut tetap berada di dompet Anda dan kami akan menghubungi Anda untuk mengatur cara lain. Ketentuan lengkap tercantum dalam Kebijakan Pengembalian Dana.
Tagihan yang kami kenakan secara keliru, misalnya karena kesalahan harga, dikembalikan sepenuhnya, termasuk biaya pemrosesan.