ConverterHQ separa autorizzazione commerciale ed esecuzione tecnica. Il lavoro fatturabile riserva prima capacità e regola i crediti solo dopo un risultato certificato.
Sandbox senza crediti di produzione
Le chiavi hq_test_... di progetto usano limiti di valutazione e settlement a zero crediti. La sandbox non è un livello gratuito permanente di produzione.
Stimare prima di eseguire
Usa gli endpoint di stima quando il costo influenza la decisione. La stima resta indicativa perché tempo motore e percorso effettivo possono variare.
Riservare e regolare
Il worker riserva prima dell’esecuzione, regola dopo successo certificato e rilascia su errore, cancellazione o output invalido. Le conversioni fallite non consumano crediti. La quota mensile conta un Job di produzione accettato che contenga una conversione, inclusi REST, workflow, link firmati e MCP. Richieste di stato, caricamenti e Job sandbox non la consumano. Ripetere un invio con la stessa Idempotency-Key conta una volta. QUOTA_EXCEEDED impedisce l'avvio del lavoro. I Job accettati falliti o annullati continuano a contare; il rilascio dei crediti segue una politica separata. Consultare il contatore dell'account tramite GET /v1/commercial.
Riconciliare l’utilizzo
Usage API e HQTools sono le fonti commerciali. Conserva client_reference_id e request_id per collegare operazioni interne a Jobs, eventi d’uso e fatture.