ConverterHQ separa autorización comercial de ejecución técnica. El trabajo facturable reserva capacidad primero y solo liquida créditos después de un resultado certificado.
Sandbox sin créditos de producción
Las claves hq_test_... asociadas a proyecto usan límites de evaluación y liquidación de cero créditos. No es un nivel gratuito permanente para producción.
Estimar antes de ejecutar
Usa los endpoints de estimación cuando el coste influya en la decisión. La cifra es orientativa porque el tiempo de motor y la ruta efectiva pueden variar.
Reservar y liquidar
El worker reserva antes de ejecutar, liquida tras éxito certificado y libera ante fallo, cancelación o salida inválida. Una conversión fallida no consume créditos de conversión. La cuota mensual cuenta un Job de producción admitido que contenga una conversión, incluidos REST, workflows, enlaces firmados y MCP. Las consultas de estado, cargas y Jobs sandbox no la consumen. Repetir una solicitud con la misma Idempotency-Key cuenta una sola vez. QUOTA_EXCEEDED impide iniciar el trabajo. Los Jobs admitidos fallidos o cancelados siguen contando; la liberación de créditos sigue una política independiente. Consulte el contador de la cuenta mediante GET /v1/commercial.
Conciliar uso
Usage API y HQTools son las fuentes comerciales. Conserva client_reference_id y request_id para unir operaciones propias con Jobs, eventos de uso y factura.