Comece pelo código de erro e X-Request-ID; depois confirme ambiente, projeto e estado durável do Job antes de repetir qualquer coisa.
Identificar a requisição
Guarde X-Request-ID, job_id, task_id e file_id. Eles separam falhas de transporte de erro do engine ou rejeição de capability.
Uploads diretos
Se o upload no navegador falhar, revise validade da URL assinada, Content-Type, tamanho declarado e CORS do storage. Os bytes não devem passar por /v1/convert.
Jobs e conversões
Inspecione Task attempts e o code. Não repita cegamente INVALID_CONVERSION_SETTINGS ou CONVERSION_OUTPUT_INVALID; corrija a requisição ou arquivo.
Escalar com contexto
Envie X-Request-ID, ambiente, horário UTC, par de formatos e etapa que falhou. Nunca envie chave completa ou documento sensível por canal não aprovado.