ConverterHQ sépare l’autorisation commerciale de l’exécution technique. Une conversion billable réserve d’abord la capacité puis ne règle les crédits qu’après un résultat certifié.
Sandbox sans crédits de production
Les clés hq_test_... liées à un projet utilisent une enveloppe d’évaluation limitée et un règlement à zéro crédit. Elles ne doivent pas être utilisées comme niveau gratuit de production permanent.
Estimer avant d’exécuter
Utilisez les endpoints d’estimation lorsque le coût influence votre décision. Une estimation reste indicative car le temps moteur et le chemin réellement exécuté peuvent varier.
Réserver puis régler
Le worker réserve les crédits avant l’exécution, règle après succès certifié et libère la réservation en cas d’échec, d’annulation ou de sortie invalide. Les échecs ne consomment pas de crédits de conversion. Le quota mensuel compte un Job de production admis contenant une conversion, y compris REST, workflows, liens signés et MCP. Les requêtes de suivi, téléversements et Jobs sandbox ne le consomment pas. Une soumission répétée avec la même Idempotency-Key compte une seule fois. QUOTA_EXCEEDED bloque le travail avant son démarrage. Les Jobs admis échoués ou annulés restent comptés ; la libération des crédits suit une politique distincte. Consultez le compteur du compte via GET /v1/commercial.
Rapprocher usage et facture
Le tableau d’usage et HQTools constituent les sources commerciales. Conservez client_reference_id et request_id pour rapprocher vos propres opérations avec Jobs, événements d’usage et facture.