Nota do autor: quando a interface de imagem retorna HTTP 451 e o código de erro image_safety, o que foi filtrado é a imagem gerada — não é a chave que foi rejeitada. Com base nas orientações da documentação da APIYI e em novos testes, este artigo explica a diferença entre esse erro e os códigos 401 e 429, além de mostrar o que mudar e por que não adianta ficar tentando de novo.
Ao chamar uma interface de imagem, você pode receber de repente um HTTP 451 com error.code igual a image_safety. A primeira reação de muita gente é pensar que a chave expirou, que faltam créditos ou que há alguma palavra sensível no comando. Aí trocam a chave, adicionam créditos e tentam várias vezes — sem sucesso. O ponto principal deste artigo é: o erro 451 image_safety bloqueia a imagem gerada; a revisão acontece depois que ela é produzida. Portanto, a investigação deve se concentrar na descrição da imagem, não na conta.
Este não é mais um artigo genérico sobre “segurança de conteúdo”. O que você vai ler a seguir se baseia nas explicações da documentação da APIYI sobre o erro 451 e nos novos testes anonimizados já divulgados. Não criamos dados de teste.
O que você vai aprender: em 1 minuto, vai saber diferenciar os erros 451, 401 e 429 e usar o método de “alterar uma variável do comando por vez” para fazer a imagem ser gerada.
Principais pontos sobre o erro 451 image_safety na geração de imagens
Veja primeiro as conclusões mais importantes. Todas se baseiam na própria mensagem de erro e na documentação — não é preciso adivinhar.
| Ponto | Explicação | Como isso ajuda você |
|---|---|---|
| A imagem de saída é o que está sendo analisado | A mensagem diz: The generated image was filtered by the safety policy |
Você não precisa mais desconfiar da chave API ou do saldo |
| A análise acontece depois da geração | A API pode gerar a imagem e, em seguida, fazer uma análise de segurança da saída. Se ela não passar, a imagem não será retornada | Você entende por que algo que “parece estar tudo certo no comando” também pode ser bloqueado |
| Isso não significa que a entrada violou as regras | Uma falha na análise posterior não significa que o comando ou a imagem de referência contenha algum termo claramente proibido | Você não precisa sair apagando termos nem trocar a imagem de referência |
| A solução é alterar o que aparece na imagem | Descrever com clareza elementos visuais, como roupas e composição, costuma ser mais eficaz do que acrescentar frases negativas | Você faz ajustes direcionados e evita tentativas desnecessárias |
| Não repita a solicitação sem alterações | Se a mesma combinação falhar várias vezes, é provável que continue retornando 451 | Você economiza tempo e custos de invocação |
Primeiro, entenda o código de erro: diferenças entre 451 image_safety, 401 e 429
Ao receber um erro, o primeiro passo é verificar o código de status e error.code, não sair alterando o código. Veja a descrição do erro 451 na documentação da APIYI (ele também aparece na FAQ e nas atualizações do centro de documentação de apiyi.com): a resposta é HTTP 451, error.code é image_safety e a mensagem é The generated image was filtered by the safety policy. A expressão-chave é “generated image”, que significa que “a imagem que já foi gerada” foi filtrada pela política de segurança.
Isso é completamente diferente de problemas de autenticação ou de limite de solicitações. Em geral, o erro 401 indica que a solicitação não passou pela verificação de identidade antes de chegar ao modelo; o 429 significa que as solicitações estão muito frequentes ou que o canal está ocupado; erros de saldo estão relacionados à cobrança. Nenhum desses três tem relação com “o que foi desenhado”. Já o 451 tem justamente a ver com “o que foi desenhado”.
| Erro | Significado comum | Etapa em que ocorre | Como resolver | Vale a pena repetir sem alterações? |
|---|---|---|---|---|
HTTP 451 image_safety |
A imagem gerada não passou pela análise de segurança da saída | Depois da geração da imagem | Altere a descrição visual e investigue uma variável de cada vez | Não. Se a mesma combinação falhar várias vezes, não repita sem alterações |
| HTTP 401 | Chave API inválida ou não enviada corretamente | Entrada da solicitação | Confira a chave API e os cabeçalhos da solicitação | Não. Não adianta repetir com a chave incorreta |
| HTTP 429 | Limite de solicitações ou canal ocupado | Entrada da solicitação ou etapa de fila | Tente novamente após um intervalo progressivo; se necessário, troque de canal | Sim, seguindo uma estratégia de espera progressiva |
| Erro de saldo | Cota insuficiente | Verificação de cobrança | Adicione créditos ou ajuste a cota | Não |
Atenção: não use a mesma lógica de repetição para 451 e 401. Para o 401, corrija a configuração da chave API; para o 451, altere o comando. Colocar os dois em uma regra genérica do tipo “se falhar, tente mais 3 vezes” só vai dificultar o diagnóstico.
Por que o erro 451 image_safety aparece só depois da geração da imagem
A documentação chama esse mecanismo de moderação posterior, também conhecida como moderação de saída. O fluxo é simples: a solicitação passa pela autenticação, o modelo gera uma imagem com base no comando e na imagem de referência, e então o sistema faz uma verificação de segurança. Se a imagem não passar, ela não é retornada e o sistema responde diretamente com o erro 451.
Por isso, você pode se deparar com uma situação em que a solicitação é bloqueada mesmo sem conter nenhuma palavra sensível. O motivo não está em uma palavra específica, mas na combinação de condições que levou o modelo a gerar uma imagem que acionou o filtro. Com isso em mente, a investigação deixa de ser uma busca por “palavras proibidas” e passa a se concentrar em controlar a imagem final.
Interpretação do reteste da documentação sobre image_safety 451
A documentação da APIYI apresenta um conjunto de retestes anonimizados com o modelo gpt-image-2.5-sunburst-vip. O cenário combina uma imagem de referência de uma pessoa com um pedido de definição visual do personagem, incluindo um close do rosto e vistas de frente, de lado e de costas do corpo inteiro, em fundo branco. Todos os dados abaixo vêm dos retestes documentados; este artigo apenas os analisa.
| Combinação testada na documentação | Resultado | Tempo | Observação |
|---|---|---|---|
| Comando original + imagem de referência original | 3/3 falhas | 81,8–95,9 segundos | Grupo de referência, erro 451 consistente |
| Mesma imagem de referência, mas com roupa neutra do dia a dia e retrato da cintura para cima | 1/1 sucesso | 35,7 segundos | Passou após a remoção das vistas de corpo inteiro |
| Comando original, sem imagem de referência, usando o endpoint de texto para imagem | 1/1 sucesso | 29,1 segundos | Passou sem as características da pessoa na imagem de referência |
| Apenas acrescentando “roupa completa, opaca e sem sexualização” | 1/1 ainda com erro 451 | 216,8 segundos | A frase negativa não resolveu |
| Especificando uma pessoa adulta, gola alta, mangas compridas, calça comprida e tênis | 3/3 sucessos | 65,1–238,6 segundos | Passou de forma consistente com a descrição positiva e explícita das roupas |
O que os retestes da documentação mostram sobre o acionamento do image_safety 451
O ponto mais relevante desses retestes está nos segundo e terceiro grupos: basta separar qualquer um dos elementos — as características da pessoa na imagem de referência ou as vistas de corpo inteiro — para que a imagem seja gerada. Com base nisso, a documentação conclui que os resultados favorecem a hipótese de que o filtro foi acionado quando as características da pessoa na imagem de referência foram combinadas com as vistas de corpo inteiro.
A documentação também deixa claro o que não se pode concluir: não dá para afirmar que a imagem de referência viola alguma regra nem que uma palavra específica tenha acionado o filtro. Isso é importante. Muitos desenvolvedores veem o erro 451 e trocam a imagem de referência ou removem várias palavras de uma vez, acabando por eliminar informações necessárias para a cena.
Por que frases negativas não resolvem o image_safety 451
No quarto grupo, foi acrescentada apenas a orientação “roupa completa, opaca e sem sexualização”, mas o erro 451 persistiu. Já no quinto grupo, a descrição foi formulada de modo positivo e específico: pessoa adulta, gola alta, mangas compridas, calça comprida e tênis. As três tentativas foram bem-sucedidas.
O motivo é simples. Uma frase negativa só diz ao modelo o que não deve fazer, sem especificar o que deve desenhar. Assim, a imagem final continua indefinida. A descrição positiva determina as peças de cima e de baixo, além do calçado, tornando o resultado mais controlável e facilitando a aprovação na análise da imagem gerada.
Sobre o tempo de processamento, a documentação faz um alerta importante: ele serve apenas como referência auxiliar e não deve ser usado isoladamente para determinar em que etapa ocorreu a análise. Nos retestes, os intervalos de tempo dos casos bem-sucedidos e dos que falharam se sobrepõem. Portanto, evite criar regras como “acima de X segundos, a solicitação foi barrada pela análise”.
Observação sobre a comparação: os dados da tabela e do gráfico vêm dos retestes documentados pela APIYI. O texto original está disponível na FAQ sobre análise de segurança de imagens geradas, no centro de documentação da apiyi.com, para você comparar com os erros que encontrar.
Diagnóstico rápido: geração de imagens retorna 451 image_safety
Confira novamente o ID do modelo: confirme qual modelo gpt-image você está usando
Depois de confirmar o erro 451, o segundo passo é verificar o ID do modelo. Nos testes de referência da documentação, foi usado gpt-image-2.5-sunburst-vip. Para conferir os modelos disponíveis da série gpt-image e seus nomes, consulte a lista de modelos da APIYI no painel de controle do apiyi.com.
Há dois motivos para verificar o ID do modelo. Primeiro, durante o diagnóstico, é importante manter o modelo inalterado; caso contrário, não será possível identificar qual variável causou o problema. Segundo, isso evita confundir um nome de modelo incorreto com um problema de moderação. Erros no nome do modelo geralmente retornam outro tipo de erro, não image_safety.
Parâmetros da requisição para investigar 451 image_safety
Este artigo não inclui blocos grandes de código: ele apenas lista os parâmetros que devem permanecer fixos durante a investigação. A interface segue o formato compatível com a OpenAI. Preencha base_url com https://api.apiyi.com/v1 e substitua api_key no SDK pela sua própria chave.
| Parâmetro | Valor de exemplo | Pode ser alterado durante a investigação? |
|---|---|---|
base_url |
https://api.apiyi.com/v1 |
Não |
model |
Use a lista de modelos da APIYI como referência. Por exemplo, o modelo usado nos testes de repetição da documentação: gpt-image-2.5-sunburst-vip |
Não |
| Endpoint | Edição de imagem (com imagem de referência) ou texto para imagem | Não, a menos que o objetivo seja testar especificamente o impacto da imagem de referência |
| Imagem de referência | Imagem de referência original | Não |
| Parâmetros como tamanho e quantidade | Manter os valores originais | Não |
prompt |
Comando original | Altere apenas uma variável por vez |
No código, recomendamos criar um ramo separado para o erro 451: leia o código de status da resposta e error.code. Se o status for 451 e o código for image_safety, registre o comando usado e interrompa as novas tentativas automáticas. Em seguida, encaminhe o caso para uma revisão manual ou um processo de reformulação baseado em regras. Para o erro 401, use o fluxo de verificação da chave; para o 429, use o fluxo de novas tentativas com espera progressiva. Não misture esses três caminhos.
Etapas para investigar 451 image_safety alterando uma variável por vez
O método de investigação apresentado na documentação pode ser organizado nesta sequência:
- Mantenha as outras condições fixas: não altere o modelo, o endpoint, a imagem de referência nem os parâmetros; modifique apenas o comando.
- Altere uma variável por vez: por exemplo, mude apenas a roupa ou apenas a quantidade de vistas. Não altere três itens de uma só vez.
- Substitua frases negativas por descrições afirmativas: especifique a parte de cima, a parte de baixo e os calçados, por exemplo, “gola alta, mangas compridas, calça comprida e tênis”. Se necessário, indique explicitamente que se trata de uma “pessoa adulta”.
- Repita o teste de 2 a 3 vezes: uma única execução bem-sucedida não garante estabilidade. Nos testes repetidos da documentação, a combinação estável teve sucesso em 3 de 3 tentativas.
- Interrompa as tentativas se a combinação original falhar repetidamente: se o grupo de referência falhar em 3 de 3 tentativas, não faz sentido continuar tentando sem alterações.
- Separe os elementos da combinação para identificar a causa: teste “remover as várias vistas de corpo inteiro” e “remover a imagem de referência” separadamente para descobrir qual combinação aciona o filtro.
🚀 Comece agora: para reproduzir e validar o problema primeiro em um ambiente limpo, recomendamos obter créditos gratuitos para testes pela APIYI, em apiyi.com. Use a mesma chave para manter o modelo e os parâmetros fixos e comparar uma variável por vez. Depois de concluir a validação, integre o fluxo ao ambiente de produção.
Exemplo de reformulação de comandos para image_safety 451
Abaixo estão algumas sugestões de reformulação, seguindo a lógica de reteste da documentação. Adapte a redação às necessidades do seu caso de uso.
| Direção da reformulação | Formulação pouco eficaz | Formulação recomendada |
|---|---|---|
| Roupas | Não seja provocante, use roupas completas | Blusa de gola alta e mangas compridas, calça comprida e tênis |
| Personagem | Uma modelo | Pessoa adulta, com a idade claramente especificada |
| Enquadramento | Faça um close do rosto e mostre o corpo inteiro de frente, de lado e de costas de uma só vez | Comece com um retrato da cintura para cima ou gere os enquadramentos em etapas |
| Estilo | Não deixe sensualizado | Roupas casuais e neutras, postura natural |
O principal objetivo da reformulação é reduzir as ambiguidades. Quanto mais específica for a descrição, menos espaço o modelo terá para improvisar e menor será a probabilidade de a imagem gerada ser filtrada.
Perguntas frequentes (FAQ)
P1: O que é 451 image_safety?
Isso significa que a imagem foi gerada, mas não passou pela análise de segurança. Por isso, a API não retorna a imagem e responde com HTTP 451 e `error.code` igual a `image_safety`. Essa é uma análise posterior à geração, também chamada de análise do lado da saída.
P2: Qual é a diferença entre 451 image_safety e 401? Devo tentar novamente nos dois casos?
O erro 401 ocorre na entrada da solicitação e está relacionado à validade da chave. Já o 451 ocorre depois da geração da imagem e está relacionado ao conteúdo visual. Os dois erros não devem usar a mesma lógica de novas tentativas: para o 401, corrija a configuração da chave; para o 451, altere a descrição da imagem. Repetir a solicitação sem mudanças não resolve nenhum dos dois.
P3: Como diferenciar 451 image_safety de 429?
O erro 429 indica limitação de taxa ou sobrecarga do canal. Em geral, tentar novamente após um intervalo resolve; se necessário, você pode trocar de canal. O erro 451 indica que o conteúdo foi filtrado. Se a mesma combinação continuar sendo usada, as novas tentativas também vão falhar. Basta verificar `error.code`: se for `image_safety`, trate como um problema relacionado ao conteúdo.
P4: Se recebi 451 image_safety, isso significa que minha imagem de referência viola as regras?
Não é possível concluir isso. Nos testes documentados, a mesma imagem de referência gerou uma imagem normalmente quando foi descrita como um retrato de meio corpo com roupas casuais e neutras. A conclusão do documento é que os resultados apontam mais para um filtro acionado pela combinação das características da pessoa na imagem de referência com uma composição de corpo inteiro em várias vistas — e não para uma violação da própria imagem de referência. Também não é possível afirmar que uma palavra específica tenha acionado o filtro.
P5: Como confirmar qual modelo gpt-image estou usando e reproduzir o erro 451?
Siga estas etapas:
1. Cadastre-se em APIYI, pelo site apiyi.com, para obter uma chave API e créditos gratuitos para testes.
2. Confira o ID exato do modelo da série gpt-image na lista de modelos.
3. Defina `base_url` como `https://api.apiyi.com/v1`, mantenha o modelo e os parâmetros fixos e siga as etapas deste artigo para investigar uma variável por vez.
P6: Posso usar o tempo de resposta para saber se a solicitação foi bloqueada pela análise?
Não é recomendável. O documento deixa claro que o tempo de resposta serve apenas como referência e não permite determinar sozinho em qual etapa ocorreu a análise. Nos testes, os tempos das solicitações bem-sucedidas e das que falharam se sobrepuseram. Usar um limite de tempo para tomar essa decisão pode levar a conclusões erradas.
P7: Depois que alterei o comando e ele passou uma vez, já posso colocar em produção?
Ainda não. O documento recomenda repetir o teste de 2 a 3 vezes: uma única aprovação não garante estabilidade. Nos testes, as combinações estáveis tiveram 3/3 tentativas bem-sucedidas. Recomendamos usar esse mesmo critério antes de colocar em produção.
451 image_safety: principais conclusões
- O que é analisado: o filtro 451
image_safetyverifica a imagem gerada, não a chave API. - Confira primeiro o código de erro: 451, 401 e 429 correspondem, respectivamente, a conteúdo, autenticação e limite de solicitações. Cada um exige uma abordagem diferente.
- Não use a mesma estratégia de nova tentativa: para 401, corrija a chave API; para 429, tente novamente com intervalos crescentes; para 451, reformule a descrição da imagem.
- Investigue alterando uma variável por vez: mantenha fixos o modelo, o endpoint, a imagem de referência e os parâmetros. Altere apenas uma parte do comando por vez.
- Descrições positivas são mais eficazes: especifique a parte de cima da roupa, a parte de baixo e os sapatos. Isso é mais confiável do que acrescentar frases negativas.
- Faça testes de regressão: depois de reformular, repita o teste de 2 a 3 vezes e só coloque em produção quando o resultado passar de forma consistente.
- Como começar: consulte a lista de modelos da APIYI para confirmar o ID do modelo e use a cota gratuita para fazer testes comparativos.
Resumo
Pontos principais sobre o erro 451 image_safety na geração de imagens:
- Identifique o problema: trata-se de uma análise do lado da saída, que bloqueia a imagem gerada. Não está relacionado à chave API, ao saldo ou ao limite de solicitações.
- Separe os casos: diferencie 451 de 401 e 429 com base no código de status e em
error.code. Não use a mesma estratégia de nova tentativa para todos. - Reformule: mantenha fixas as demais variáveis e substitua frases negativas por descrições positivas e específicas das roupas e da composição. Depois, repita o teste de 2 a 3 vezes.
Se encontrar um erro 451, não troque a chave API de imediato. Primeiro, tente descrever a imagem de forma mais específica. Recomendamos usar a APIYI em apiyi.com, manter o mesmo modelo e a mesma chave API e alterar uma variável por vez para encontrar rapidamente uma descrição que gere imagens de forma consistente.
📚 Referências
- FAQ da APIYI: análise de segurança da saída de imagens: definição do erro 451
image_safetye como investigá-lo - Link:
docs.apiyi.com/faq/image-output-safety-review.md -
Descrição: inclui os formatos de resposta, explicações sobre a análise posterior e recomendações para investigar uma variável por vez
-
Atualização da APIYI: análise de segurança da saída de imagens (2026-11): registro de novos testes da documentação
- Link:
docs.apiyi.com/live/2026-11/image-output-safety-review.md - Descrição: reúne novos testes anonimizados com
gpt-image-2.5-sunburst-vipe os limites das conclusões
Autor: equipe técnica da APIYI
Contato técnico: entre em contato conosco pela página inicial da APIYI em apiyi.com. Para mais informações sobre códigos de erro de APIs de imagem, consulte a central de documentação em docs.apiyi.com
