Erros e novas tentativas
O que cada status significa e o que fazer.
Erros são JSON com um campo detail. Use o status e os cabeçalhos de nova tentativa; mantenha detail para logs e orientações ao usuário.
| Status | Significado | O que fazer |
|---|---|---|
400 | Entrada inválida, mecanismo desconhecido ou rota incorreta | Corrija a solicitação ou escolha um mecanismo disponível |
401 | PIN ou chave de API ausente ou incorreta | Envie a credencial |
403 | O solicitante não pode usar uma rota local ou administrativa | Use loopback ou uma rota permitida |
409 | Falta um modelo ou estado necessário | Instale o modelo recomendado ou resolva o conflito |
422 | O corpo não passou na validação | Corrija nomes, tipos ou intervalos dos campos |
429 | A fila da GPU está cheia | Aguarde Retry-After e tente novamente |
500 | Falha inesperada do mecanismo ou servidor | Registre detail; tente novamente apenas se for seguro |
503 | Carregamento do mecanismo ou geração temporariamente indisponível | Respeite Retry-After |
504 | Uma transcrição ou geração protegida excedeu o tempo limite | Tente uma vez; reduza o trabalho se ocorrer novamente |
Novas tentativas
Repita 429, 503 repetível e 504 com espera exponencial limitada. O VoiceStudio pode enviar:
Retry-After: 30
X-OmniVoice-Retryable: trueNão repita 400, 401, 403 ou 422 automaticamente. Um 409 exige primeiro instalar um modelo ou fazer outra alteração explícita.
Para dublagem e tarefas em lote, retome pelo status da tarefa após uma queda de conexão em vez de enviar a mídia novamente.