ConverterHQDevelopers
API v1

Faturalama ve kullanım

Credit, tahmin, sandbox, quota ve yürütme sonrası mutabakatı anlayın.

ConverterHQ ticari yetkiyi teknik yürütmeden ayırır. Ücretli iş önce kapasite rezerve eder, credits yalnız sertifikalı başarıdan sonra settle edilir.

Üretim credits olmadan sandbox

Projeye bağlı hq_test_... anahtarları değerlendirme limitleri ve zero-credit settlement kullanır. Sandbox kalıcı ücretsiz üretim katmanı değildir.

Çalıştırmadan önce tahmin

Maliyet kararınızı etkiliyorsa estimate endpoint’lerini kullanın. Engine süresi ve gerçek route değişebileceği için değer tahminidir.

Reserve ve settle

Worker yürütmeden önce reserve eder, sertifikalı başarıdan sonra settle eder; hata, iptal veya geçersiz output’ta release eder. Başarısız dönüşüm credit tüketmez. Aylık kota; REST, iş akışları, imzalı bağlantılar ve MCP dahil, dönüştürme içeren kabul edilmiş her üretim Job'unu bir kez sayar. Durum sorguları, yüklemeler ve sandbox Job'ları kotayı tüketmez. Aynı Idempotency-Key ile yeniden gönderim bir kez sayılır. QUOTA_EXCEEDED işin başlamasını engeller. Başarısız veya iptal edilmiş kabul edilmiş Job'lar sayılmaya devam eder; kredilerin serbest bırakılması ayrı bir politikaya tabidir. Hesap sayacına GET /v1/commercial ile erişin.

Kullanımı mutabıklaştırın

Usage API ve HQTools ticari kaynaklardır. client_reference_id ve request_id ile kendi işlemlerinizi Jobs, usage events ve fatura ile eşleyin.