ConverterHQDevelopers
API v1

Billing dan usage

Pahami credit, estimasi, sandbox, quota, dan rekonsiliasi setelah eksekusi.

ConverterHQ memisahkan otorisasi komersial dari eksekusi teknis. Pekerjaan berbayar mereservasi kapasitas terlebih dahulu dan hanya melakukan settlement setelah output tersertifikasi.

Sandbox tanpa credit produksi

Project test key memakai limit evaluasi dan zero-credit settlement. Sandbox bukan free tier permanen untuk traffic produksi.

Estimasi sebelum eksekusi

Gunakan endpoint estimate ketika biaya memengaruhi keputusan. Nilainya indikatif karena runtime engine dan route aktual dapat berbeda.

Reserve lalu settle

Worker mereservasi sebelum eksekusi, settle setelah sukses tersertifikasi, dan release pada gagal, cancel, atau output invalid. Konversi gagal tidak memakai conversion credit. Kuota bulanan menghitung satu Job produksi yang diterima dan berisi konversi, termasuk REST, workflow, tautan bertanda tangan, dan MCP. Pemeriksaan status, unggahan, dan Job sandbox tidak mengurangi kuota. Pengiriman ulang dengan Idempotency-Key yang sama dihitung sekali. QUOTA_EXCEEDED mencegah pekerjaan dimulai. Job yang diterima tetap dihitung jika gagal atau dibatalkan; pelepasan kredit mengikuti kebijakan terpisah. Lihat penghitung akun melalui GET /v1/commercial.

Rekonsiliasi usage

Usage API dan HQTools adalah sumber komersial. Simpan client_reference_id dan request_id untuk menghubungkan transaksi internal dengan Jobs, event usage, dan invoice.