Langsung ke konten utama

​
Potongan kredit terjadi di awal

Saat POST /api/v1/generate diterima, kredit langsung dipotong sebelum job masuk antrean. Kalau job berakhir failed, kredit dikembalikan otomatis. Kamu tidak menanggung biaya kegagalan mesin. Yang tidak dikembalikan: job yang kamu batalkan sendiri setelah berhasil terkirim, dan request yang ditolak sebelum job dibuat (karena itu memang tidak pernah memotong apa pun).

​
Cara harga dihitung

Server mencari harga dengan urutan berikut, berhenti di kecocokan pertama:
1

quality:resolution

Untuk model gambar yang punya kedua kunci itu, contoh low:2K.
2

resolution:duration

Kombinasi seperti 720p:15; pengecekan toleran terhadap urutan dan akhiran s.
3

duration

Override tunggal per durasi, contoh "30": 15.
4

resolution

Override tunggal per resolusi, contoh "4K": 2.
5

creditsDefault

Harga dasar model.
Karena itu harga bisa beda untuk request yang tampak mirip: resolution: "720p", duration: "30" bisa lebih mahal daripada duration: "15".
Angka harga diatur admin dan bisa berubah. Satu-satunya sumber kebenaran adalah priceMatrix dan creditsDefault dari GET /api/v1/models — jangan salin tabel harga ke kode kamu.

​
Biaya referensi

Menambah gambar atau video referensi tidak menambah harga pada saat ini (referenceSurcharge bernilai 0). Untuk model motion control, durasi video referensi justru menentukan durasi keluaran — dan durasi itulah yang ditagih.

​
Kredit tidak cukup

Status 402. Tidak ada job yang dibuat, tidak ada kredit yang terpakai. Cara paling hemat menghindari error ini adalah membaca saldo sebelum mengirim batch — lihat GET /api/v1/user/credits.

​
Paket Unlimited

Pembelian Unlimited memberi kuota waktu, bukan saldo kredit. Saat aktif, generate pada model yang memenuhi syarat memotong 0 kredit dan field creditsCharged di respons bernilai 0. Ada batasnya:
  • Hanya model video/gambar tertentu yang ikut kuota Unlimited. Model lain tetap memotong kredit normal walaupun akunmu Unlimited. Cek eligibility dengan unlimited.active di /api/v1/user/credits, lalu cocokkan model lewat dashboard.
  • Maksimal 2 proses bersamaan. Yang ketiga dijawab 429.
  • Kuota harian video tetap berlaku (50 video sukses per hari).

​
Bayar dan cek saldo

Pulsa kredit lewat dashboard (QRIS). Pemantauan saldo sebaiknya dilakukan di servermu, bukan di frontend:
credits bisa berupa angka pecahan (misalnya 1.5) karena beberapa model gambar berharga di bawah satu kredit. Jangan bulatkan ke bawah di sisi kamu sebelum membandingkan dengan harga.