A resposta curta
Quando a geração de imagem falha no Whizi, o texto do erro diz que tipo de falha foi: uma barreira de plano, uma cota esgotada, uma recusa do filtro de conteúdo, uma solicitação rejeitada ou uma falha do provedor depois que o trabalho já havia começado. Só os dois primeiros casos são resolvidos trocando de plano. Falhas do provedor costumam ser resolvidas enviando o mesmo prompt de novo, e elas devolvem o que foi reservado.
A geração de imagem está incluída nos planos Pro e Powerhouse. Contas Free e Starter têm cota de imagem igual a zero, então nesses planos a recusa é o comportamento esperado, não uma falha.
| Erro exibido | O que aconteceu | O que fazer |
|---|---|---|
Choose a subscription to generate images. | Uma conta gratuita pediu uma imagem (HTTP 402) | Assine o Pro ou o Powerhouse |
Upgrade to Pro or Powerhouse to generate images. | Um plano pago sem cota de imagem, que é o Starter (HTTP 403) | Faça upgrade para Pro ou Powerhouse |
Your monthly image generation limit has been reached. | O contador de imagens do período se esgotou (HTTP 429) | Espere o próximo período ou faça upgrade |
Your weekly image generation limit has been reached. | O mesmo caso, em um ciclo de cobrança semanal (HTTP 429) | Espere o próximo período ou faça upgrade |
Image generation could not be started. Please try again. | O provedor recusou o trabalho no envio (HTTP 429 ou 502) | Envie de novo. A reserva foi devolvida |
The image provider could not complete this generation. | O provedor aceitou o trabalho e depois reportou falha | Envie de novo ou tente outro modelo de imagem. A reserva foi devolvida |
Image prompts must be between 1 and 4000 characters. | O prompt estava vazio ou passava do limite (HTTP 400) | Encurte o prompt |
Plano e cota: as duas recusas que não são falhas
A geração de imagem é medida em um contador próprio, separado das mensagens de texto. Um trabalho de imagem independente consome apenas o contador de imagem, não o saldo de créditos.
| Plano | Gerações de imagem por período mensal |
|---|---|
| Free | 0 |
| Starter | 0 |
| Pro | 100 |
| Powerhouse | 500 |
Em um período de cobrança semanal, o número é a cota mensal dividida por quatro, arredondada para cima.
Uma conta gratuita recebe Choose a subscription to generate images. como HTTP 402 com o código subscription_required. Uma conta paga cujo plano não traz cota de imagem recebe Upgrade to Pro or Powerhouse to generate images. como HTTP 403 com o código tier_upgrade_required. Hoje esse segundo caso é o Starter, porque Starter e Free são os dois planos com cota igual a zero.
Quando o contador do período se esgota, a mensagem é Your monthly image generation limit has been reached. num ciclo mensal e Your weekly image generation limit has been reached. num ciclo semanal, ambas HTTP 429 com o código image_limit_reached. O contador é por período de cobrança, então as opções são esperar o período virar ou fazer upgrade de plano. O contador de imagem é um medidor separado do saldo de créditos.
O trabalho começou e depois falhou
Essas são falhas do provedor. Vale a pena tentar de novo, porque o mesmo prompt costuma dar certo na segunda tentativa, e porque as duas falhas mais comuns devolvem sua cota.
Image generation could not be started. Please try again. é retornado quando a chamada de envio falha: HTTP 429 com o código image_provider_rate_limited quando o provedor responde com limite de taxa, e HTTP 502 com o código image_submit_failed nos outros casos. A reserva é devolvida antes de o erro ser retornado.
The image provider could not complete this generation. é gravado no registro do trabalho quando o provedor aceita o trabalho e depois o reporta como falho. A reserva também é devolvida nesse ponto.
Image generation status is temporarily unavailable. significa que a consulta de status falhou, não a geração em si: HTTP 429 quando a consulta upstream sofre limite de taxa e HTTP 502 nos outros casos, ambos com o código image_status_failed. O trabalho ainda pode estar rodando, então recarregue a página antes de supor que ele morreu.
Image job not found. é HTTP 404 com o código image_job_not_found, retornado quando o id do trabalho não é resolvido.
Três mensagens mais raras significam que a imagem foi produzida, mas não pôde ser recuperada ou armazenada: The completed image could not be saved. quando a imagem finalizada não pode ser copiada para o armazenamento, Generated image could not be downloaded. quando a busca da imagem do provedor não retorna OK ou declara um tamanho acima do limite, e Generated image exceeded the size limit. quando a imagem baixada está vazia ou acima do limite de bytes. Duas outras ficam antes nessa cadeia: Image provider returned an invalid URL. é disparado quando a URL do resultado do provedor está ausente ou fora da lista de hosts permitidos, e Image result was unavailable. quando a busca do resultado não é bem sucedida. Tentar de novo é a única ação possível do usuário em todos esses casos.
Something went wrong. Please retry. é o corpo do HTTP 500 com o código internal_error, usado para qualquer erro de backend não tratado, então não carrega diagnóstico próprio. Se ele continuar aparecendo no mesmo prompt, um prompt diferente não vai resolver, e o suporte está acessível a partir das Configurações.
Erros que rejeitam a solicitação antes da geração
Choose Whizi Image, Nano Banana, FLUX, or Stable Diffusion. é HTTP 400 com o código invalid_image_model, retornado quando o modelo da solicitação não é um modelo de geração de imagem. Esses quatro nomes são os modelos de imagem que o catálogo oferece.
Image prompts must be between 1 and 4000 characters. é HTTP 400 com o código invalid_image_prompt. Um prompt vazio e um prompt de 5.000 caracteres falham na mesma verificação.
Se você está gerando dentro de um chat em vez de como um trabalho independente, as mensagens vêm do fluxo de chat. The model is temporarily rate-limited. Please retry shortly. é HTTP 429 com o código provider_rate_limited, retornado quando o provedor de mídia responde à solicitação com limite de taxa. Qualquer outra falha nesse fluxo retorna Error generating response. Please try again. como HTTP 502 com o código provider_error. Ambas valem uma simples nova tentativa.
Um prompt de imagem dentro do chat também pode ser interrompido pelos erros comuns de envio de chat, que não são erros de imagem e estão documentados em sua própria página: um envio duplicado, uma geração já em andamento na conta e um prompt editado cuja mensagem original sumiu da conversa. Veja mensagem não está sendo enviada.
O prompt foi recusado, não falhou
As recusas por política de conteúdo retornam HTTP 400 em vez de 403, deliberadamente, porque os clientes já renderizam a mensagem de erro em um 400. Assim, uma recusa aparece como um erro comum na interface, mesmo que nada tenha quebrado.
A triagem roda antes de qualquer cota ser reservada e antes de o provedor ser chamado, o que significa que um prompt recusado não custa nenhuma cota.
As três recusas mais prováveis de atingir um prompt de imagem:
Whizi does not create sexual or suggestive content involving minors. This request was not sent to any model. If you think this was a mistake, contact support from Settings.(códigocontent_policy_minor_safety)Whizi does not create sexual content featuring real, identifiable people. If you think this was a mistake, contact support from Settings.(códigocontent_policy_real_person). Essa regra se aplica apenas a solicitações de geração, não ao chat de texto, e é por isso que o mesmo texto pode passar em uma conversa e falhar em uma imagem.Whizi cannot help with building weapons, explosives, or other things designed to hurt people. If you think this was a mistake, contact support from Settings.(códigocontent_policy_weapons)
Se o filtro foi acionado repetidamente em prompts de geração, a conta recebe um bloqueio e vê Generation is paused on this account after repeated requests that Whizi cannot fulfil. It reopens automatically. Contact support from Settings if you think this is wrong. como HTTP 429 com o código content_policy_locked. A mensagem já traz sua própria solução: ela reabre automaticamente, e o suporte está acessível a partir das Configurações.
Uma imagem que foi gerada normalmente e não carrega mais
Uma imagem gerada fica armazenada no servidor, e não fica lá para sempre. Anexos enviados e mídia gerada são configurados para expirar em até 30 dias, então a imagem em um chat antigo não é um endereço permanente.
Media has expired. é HTTP 404 com o código media_expired, retornado quando o objeto armazenado passou da janela de retenção.
Media not found. é HTTP 404 com o código media_not_found, retornado quando o id da mídia não é resolvido para sua conta de forma alguma.
Baixar é a única cópia durável. Um chat não é armazenamento.
- A geração de imagem está disponível só em Pro e Powerhouse, com 100 e 500 por período mensal
- Free e Starter têm cota de imagem igual a zero, então recusas nesses planos são esperadas
- A cobrança semanal recebe a cota mensal dividida por quatro, arredondada para cima
- Um trabalho de imagem independente consome só o contador de imagem, não seu saldo de créditos
- Falhas de envio e falhas do provedor devolvem a reserva automaticamente
- Recusas por política de conteúdo são filtradas antes de qualquer cota ser reservada, então não custam nada
- Um bloqueio por política de conteúdo reabre automaticamente, e o suporte está acessível nas Configurações
- A mídia gerada é configurada para expirar em até 30 dias, então baixe o que quiser manter
Perguntas frequentes
O que significa "Choose a subscription to generate images."?
Significa que a conta está no plano gratuito, que tem cota de imagem igual a zero. O erro é HTTP 402 com o código subscription_required. O equivalente pago é "Upgrade to Pro or Powerhouse to generate images.", HTTP 403, que aparece em um plano pago sem cota de imagem. A geração de imagem está incluída no Pro com 100 por período mensal e no Powerhouse com 500.
Estou no Starter e toda solicitação de imagem é recusada. Isso é um bug?
Não. O Starter tem cota de imagem igual a zero, assim como o Free, então a recusa é o comportamento esperado e nenhuma quantidade de tentativas vai mudar isso. O Starter alcança quatro ids para chat de texto, incluindo o Auto, que é um roteador e não um modelo. A geração de imagem não faz parte do plano, e o Pro é o plano mais baixo que a inclui.
Uma geração de imagem que falhou ainda consome uma geração?
Normalmente não. Um trabalho de imagem reserva contra o contador de imagem antes de o provedor ser contatado, e essa reserva volta nas duas falhas do provedor citadas acima. Uma recusa do filtro nunca chega à etapa de reserva, então não há nada para devolver, para começo de conversa.
Por que meu prompt de imagem foi recusado se o mesmo texto funciona em um chat?
Uma regra é deliberadamente exclusiva para geração. A recusa sobre conteúdo sexual envolvendo pessoas reais e identificáveis se aplica a solicitações de geração e não ao chat de texto, então uma frase que passa em uma conversa pode ser recusada como prompt de imagem. Toda recusa por política de conteúdo retorna HTTP 400, e é por isso que ela chega parecendo um erro comum em vez de um aviso de política.
Minha imagem gerada não carrega mais. Para onde ela foi?
Dois 404 diferentes produzem esse sintoma, e o código distingue os dois. "Media has expired." (código media_expired) significa que o objeto armazenado passou da janela de retenção; a mídia gerada é configurada para expirar em até 30 dias. "Media not found." (código media_not_found) significa que o id não é resolvido para sua conta de forma alguma. Nenhum dos dois estados pode ser desfeito pela interface.