Önce error code ve X-Request-ID ile başlayın; retry yapmadan environment, proje ve durable Job state’i kontrol edin.
İsteği tanımlayın
X-Request-ID, job_id, task_id ve file_id saklayın. Böylece transport sorunu ile engine veya capability reddini ayırabilirsiniz.
Doğrudan upload
Browser upload başarısızsa signed URL süresi, Content-Type, bildirilen boyut ve storage CORS’u kontrol edin. Dosya byte’ları /v1/convert üzerinden gitmemelidir.
Jobs ve dönüşümler
Task attempts ve code değerini inceleyin. INVALID_CONVERSION_SETTINGS veya CONVERSION_OUTPUT_INVALID için kör retry yapmayın; request veya file’ı düzeltin.
Bağlamla eskale edin
X-Request-ID, environment, UTC zamanı, format çifti ve başarısız adımı sağlayın. Tam API key veya hassas dosyayı onaysız kanalda paylaşmayın.