Pontos principais
1. O formato pedido não é aceito pelo modelo
Os modelos não compartilham um vocabulário de tamanho. Alguns aceitam uma faixa de resolução, outros uma proporção, outros dimensões explícitas, e uma combinação válida em um modelo não significa nada em outro. É a falha silenciosa mais comum, porque ela também pode ter sucesso e devolver uma imagem corretamente gerada, mas em proporções erradas. Se a saída é o sujeito certo no formato errado, é a sua categoria, e a correção é definir o formato explicitamente, não mudar o prompt.
2. Falta uma entrada obrigatória
Modelos de imagem para imagem e de imagem para vídeo precisam de uma imagem de origem, e alguns precisam de mais de uma. Um modelo que parece não fazer nada quando você aperta gerar geralmente está esperando um campo de upload que não foi preenchido. Esse caso não custa nada além de tempo, e vale conferir antes de supor que algo está quebrado.
3. O saldo não cobre as configurações escolhidas
O custo cresce com a duração e a resolução, então o mesmo modelo pode ser acessível numa configuração e inacessível em outra. Uma geração que para antes de começar, sem produzir nada, costuma ser isso. Reduzir primeiro a duração é a forma mais rápida de trazer um modelo de volta ao alcance, e é também a configuração com maior chance de melhorar o resultado.
4. O próprio modelo não está mais disponível
Modelos hospedados são descontinuados pelos provedores, às vezes sem aviso, e um modelo que funcionava no mês passado pode deixar de existir. Verificamos o nosso catálogo para isso e escondemos endpoints que sumiram, mas sempre há uma janela entre o provedor fechar uma rota e nós percebermos. Se um modelo específico falha repetidamente enquanto outros funcionam, essa é a causa provável; mudar para outro modelo da mesma família é a solução imediata.
Versões e opções
- Confira se algo foi produzido. Nada indica entradas, saldo ou disponibilidade; um resultado com aparência errada indica formato ou prompt.
- Confirme que todos os campos de upload pedidos pelo modelo estão preenchidos.
- Reduza a duração ou a resolução e tente de novo uma vez: isso cobre o caso do saldo e parte do caso do formato.
- Experimente outro modelo de uma família diferente. Se funcionar, o problema é o primeiro modelo, não o seu pedido.
- Se o mesmo modelo falha em todas as configurações enquanto outros funcionam, trate-o como indisponível e siga em frente em vez de repetir.
- Só reescreva o prompt depois de descartar as quatro verificações acima.
Evidências e orientação
5. O pedido foi recusado por motivo de conteúdo
Todo modelo hospedado aplica seus próprios filtros, que diferem entre si e dos nossos. Uma recusa não é a mesma coisa que um erro: significa que o pedido foi entendido e negado. Reescrever raramente ajuda se o próprio assunto está fora do escopo, e vale ler a resposta em vez de supor uma falha técnica: os dois casos parecem iguais por fora e exigem respostas opostas.
O sexto caso: deu certo, e está errado
É o caso que as pessoas não contam como falha, e é a categoria mais cara em volume, porque consome créditos toda vez. Uma geração que devolve um resultado limpo e bem renderizado que não é o que você pediu quase nunca é falha do modelo: é uma instrução que o modelo nunca recebeu. Os culpados de sempre são um formato não declarado, um movimento descrito como adjetivo em vez de movimento, ou um prompt de imagem para vídeo que redescreve o sujeito e assim o convida a ser reinterpretado. Antes de supor que o modelo é fraco, confira o que o prompt realmente especificou, e não o que você quis dizer com ele.
Por que repetir o mesmo pedido às vezes funciona
Pedidos idênticos nem sempre produzem resultados idênticos, então uma nova tentativa às vezes dá certo onde a primeira falhou. Vale saber, e também é uma armadilha: se a causa é uma entrada ausente, um modelo indisponível ou uma configuração fora do alcance, repetir tem garantia de falhar de novo e continuará custando. Uma única nova tentativa é um teste razoável para saber se você pegou ruído transitório. Uma terceira tentativa sem mudar nada não é estratégia: a essa altura, a resposta é que algo no pedido precisa ser diferente.
Decidir se é você ou nós
Um jeito rápido de localizar o problema: rode outro modelo que use uma família diferente, com as configurações mais simples possíveis. Se funcionar, o problema é específico do primeiro modelo, e a correção mais rápida é usar outro em vez de continuar depurando. Se também falhar, o problema está mais provavelmente no caminho compartilhado — entradas, saldo ou o próprio pedido — e as verificações abaixo o encontram mais rápido que qualquer reescrita de prompt.
