Falhas na geração de imagens

A geração de imagens pode falhar mesmo quando o formato da requisição está correto. A maioria das falhas vem de regras de segurança do provedor, objetivos de prompt não suportados, problemas com imagem de referência, capacidade temporária ou limites de taxa. O Pixapi mantém resposta da API, estado da tarefa e livro de créditos alinhados para que seu produto mostre o próximo passo correto.

Diagnóstico rápido

O que aparece	Causa provável	Próxima ação
Mensagem de segurança ou política	O prompt ou a imagem de referência acionou verificações de segurança	Remova conteúdo restrito, simplifique o prompt e tente novamente com uma descrição mais segura.
Sem imagem ou saída apenas em texto	O modelo respondeu sem uma parte de imagem	Inspecione as partes da resposta, a modalidade solicitada, a complexidade do prompt e o suporte do modelo.
Timeout, 503 ou provedor indisponível	Capacidade temporária do provedor ou problema de rede	Tente novamente com backoff limitado e mantenha o mesmo payload para uma verificação.
Erro de upload ou imagem de referência	Formato não suportado, arquivo grande, corrompido ou URL inacessível	Use PNG, JPEG ou WebP, mantenha arquivos pequenos e confirme que o Pixapi consegue acessar a URL.
429 ou limite de taxa	Pressão de taxa na conta, modelo ou provedor	Use backoff com jitter e coloque trabalhos não urgentes em fila.
insufficient_credits	O saldo era baixo antes da geração começar	Peça ao usuário para comprar créditos; isso não é um caso de reembolso por falha de geração.

Causas comuns

Segurança e conteúdo restrito

Provedores de imagem podem bloquear prompts ou imagens de referência com conteúdo sexual explícito, violência gráfica, ódio ou assédio, automutilação, atividade ilegal ou conteúdo inadequado envolvendo menores. Essas regras podem ser aplicadas durante a geração, não apenas na validação inicial.

Remoção de marca d'água e material protegido

Pedidos para remover marcas d'água, reproduzir personagens protegidos, copiar IP famosa ou imitar figuras públicas podem ser rejeitados ou não retornar uma imagem útil. Reformule a solicitação como um conceito original, use ativos licenciados ou descreva um estilo visual geral.

Complexidade do prompt

Prompts muito longos, instruções conflitantes, requisitos densos de texto ou muitos sujeitos podem causar saída apenas em texto, saída parcial ou nenhuma imagem. Reduza o pedido ao sujeito principal, estilo, composição e requisitos de saída antes de adicionar detalhes novamente.

Problemas com imagens de referência

Pedidos de edição e imagem-para-imagem dependem do ativo de entrada. Verifique se a URL está acessível, se o arquivo não está corrompido e se o formato é suportado. Se uma URL assinada expira rápido, envie a imagem novamente ou use uma URL de duração maior.

Problemas temporários do provedor

Capacidade do provedor, limites de taxa e timeouts upstream podem ocorrer de forma intermitente. Em produção, tente novamente poucas vezes com backoff exponencial e jitter. Mantenha o mesmo modelo, payload e imagem de referência para um primeiro reteste de diagnóstico.

Créditos reembolsados

Se créditos foram consumidos ou reservados, mas o trabalho de geração falha antes de entregar uma saída faturável, o Pixapi devolve os créditos afetados à sua conta. O livro de créditos mostra essas linhas como Reembolsado.

Abra Créditos para revisar linhas reembolsadas. Uma linha reembolsada significa que o saldo foi restaurado; não significa que o prompt original terá sucesso sem alterações.

O que registrar antes de contatar suporte

Inclua request id ou task id, modelo, horário, prompt sem dados sensíveis, formato e tamanho da imagem de entrada, código de erro de resposta e se os créditos foram reembolsados. Isso ajuda a diferenciar bloqueios de política, problemas de payload, indisponibilidade do provedor e conciliação de cobrança.