ConverterHQDevelopers
API v1

Facturatie en gebruik

Begrijp credits, schattingen, sandbox, quota en afrekening na uitvoering.

ConverterHQ scheidt commerciële toestemming van technische uitvoering. Betaalbaar werk reserveert eerst capaciteit en rekent pas af na gecertificeerd succes.

Sandbox zonder productiecredits

Projectgebonden hq_test_... sleutels gebruiken evaluatielimieten en zero-credit settlement. Sandbox is geen permanente gratis productietier.

Vooraf schatten

Gebruik estimate-endpoints wanneer kosten de beslissing beïnvloeden. Het bedrag blijft indicatief omdat engine-tijd en werkelijk pad kunnen variëren.

Reserveren en afrekenen

De worker reserveert voor uitvoering, settelt na gecertificeerd succes en geeft vrij bij fout, annulering of ongeldige output. Mislukte conversies kosten geen conversion credits. De maandlimiet telt één toegelaten productie-Job met een conversie, inclusief REST, workflows, ondertekende links en MCP. Statusverzoeken, uploads en sandbox-Jobs verbruiken deze niet. Herhalen met dezelfde Idempotency-Key telt eenmaal. QUOTA_EXCEEDED voorkomt dat het werk begint. Mislukte of geannuleerde toegelaten Jobs blijven meetellen; voor het vrijgeven van credits geldt een apart beleid. Bekijk de accountteller via GET /v1/commercial.

Gebruik reconciliëren

Usage API en HQTools zijn commerciële bronnen. Bewaar client_reference_id en request_id om eigen transacties aan Jobs, usage-events en facturen te koppelen.