ConverterHQ trennt kommerzielle Berechtigung von technischer Ausführung. Billable Jobs reservieren zunächst Kapazität und rechnen Credits erst nach zertifiziertem Erfolg ab.
Sandbox ohne Produktionscredits
Projektgebundene hq_test_... Schlüssel nutzen begrenzte Evaluierungs-Limits und Zero-Credit-Settlement. Die Sandbox ist kein dauerhafter kostenloser Produktionsplan.
Vorher schätzen
Nutzen Sie Estimate-Endpunkte, wenn Kosten Ihre Entscheidung beeinflussen. Eine Schätzung bleibt indikativ, weil Engine-Laufzeit und ausgeführter Pfad variieren können.
Reservieren und abrechnen
Der Worker reserviert vor Ausführung, settelt nach zertifiziertem Erfolg und gibt bei Fehler, Abbruch oder ungültigem Output frei. Fehlgeschlagene Konvertierungen verbrauchen keine Conversion-Credits. Das Monatskontingent zählt jeden zugelassenen Produktions-Job mit einer Konvertierung, einschließlich REST, Workflows, signierter Links und MCP. Statusabfragen, Uploads und Sandbox-Jobs verbrauchen es nicht. Wiederholungen mit derselben Idempotency-Key zählen einmal. QUOTA_EXCEEDED verhindert den Arbeitsbeginn. Fehlgeschlagene oder abgebrochene zugelassene Jobs zählen weiterhin; für die Freigabe von Credits gilt eine separate Richtlinie. Der Kontozähler ist über GET /v1/commercial verfügbar.
Nutzung abgleichen
Usage-API und HQTools sind die kommerziellen Quellen. Bewahren Sie client_reference_id und request_id auf, um eigene Vorgänge mit Jobs, Usage-Events und Rechnung zu verbinden.