ConverterHQDevelopers
API v1

Rozliczenia i użycie

Zrozum credits, estymacje, sandbox, quota i rozliczenie po wykonaniu.

ConverterHQ rozdziela uprawnienie komercyjne od wykonania technicznego. Płatna praca najpierw rezerwuje pojemność, a credits są rozliczane dopiero po certyfikowanym sukcesie.

Sandbox bez credits produkcyjnych

Projektowe hq_test_... korzystają z limitów ewaluacyjnych i zero-credit settlement. Sandbox nie jest stałym bezpłatnym tierem produkcyjnym.

Estymuj przed wykonaniem

Użyj endpointów estimate, gdy koszt wpływa na decyzję. Wynik jest orientacyjny, bo runtime engine i rzeczywista ścieżka mogą się różnić.

Rezerwuj i rozliczaj

Worker rezerwuje przed wykonaniem, rozlicza po certyfikowanym sukcesie i zwalnia przy błędzie, anulowaniu lub niepoprawnym output. Nieudane konwersje nie zużywają credits. Limit miesięczny uwzględnia jeden przyjęty produkcyjny Job zawierający konwersję, w tym REST, workflow, podpisane linki i MCP. Zapytania o status, przesyłanie plików i Joby sandbox nie zużywają limitu. Ponowienie z tą samą Idempotency-Key liczy się raz. QUOTA_EXCEEDED blokuje rozpoczęcie pracy. Przyjęte Joby zakończone błędem lub anulowane nadal się liczą; zwalnianie kredytów podlega osobnym zasadom. Licznik konta jest dostępny przez GET /v1/commercial.

Uzgadniaj użycie

Usage API i HQTools są źródłami komercyjnymi. Zachowaj client_reference_id i request_id, aby łączyć własne operacje z Jobs, eventami i fakturą.