ConverterHQDevelopers
API v1

Cobrança e uso

Entenda créditos, estimativas, sandbox, quotas e reconciliação após execução.

ConverterHQ separa autorização comercial da execução técnica. Trabalho faturável reserva capacidade primeiro e só liquida créditos depois de um resultado certificado.

Sandbox sem créditos de produção

Chaves hq_test_... de projeto usam limites de avaliação e liquidação zero. O sandbox não é um plano gratuito permanente de produção.

Estimar antes de executar

Use endpoints de estimativa quando custo mudar sua decisão. O valor é indicativo porque tempo do engine e rota realmente executada podem variar.

Reservar e liquidar

O worker reserva antes da execução, liquida após sucesso certificado e libera em falha, cancelamento ou saída inválida. Falhas não consomem créditos de conversão. A quota mensal conta um Job de produção aceite que contenha uma conversão, incluindo REST, workflows, ligações assinadas e MCP. Consultas de estado, carregamentos e Jobs sandbox não a consomem. Repetir uma submissão com a mesma Idempotency-Key conta uma vez. QUOTA_EXCEEDED impede o início do trabalho. Jobs aceites que falhem ou sejam cancelados continuam a contar; a libertação de créditos segue uma política separada. Consulte o contador da conta através de GET /v1/commercial.

Reconciliar uso

Usage API e HQTools são as fontes comerciais. Guarde client_reference_id e request_id para relacionar operações próprias a Jobs, eventos e fatura.