Por que o Grok marca uma imagem como moderated: política, limites e alternativas

Separe a recusa por política do limite de uso, aprenda a diagnosticar cada caso e decida quando enviar o trabalho de imagem para outro modelo.

Conclusão principalTrate moderated como um estado observável do produto, não como uma regra a ser adivinhada reescrevendo o prompt várias vezes.

Resposta rápida

Moderated significa que uma política de conteúdo bloqueou aquela requisição específica. Não é cota esgotada nem instabilidade do serviço. Separe primeiro quatro estados na resposta — recusa por política, limite de requisições, cota esgotada e falha do modelo — e só então decida se muda a entrada, espera a cota reiniciar ou envia o trabalho para um modelo de imagem que permita aquele conteúdo.

Comece pela pergunta por trás da busca

Quando uma imagem do Grok aparece como moderated, o usuário vê um único resultado, mas o time de produto tem várias causas possíveis pela frente: o texto do prompt, uma imagem de referência, o risco de usar uma pessoa real, regras por região, o estado da conta ou uma mudança de política da plataforma. A pior reação é rotular qualquer falha como “o modelo não suporta” ou deixar o usuário tentar de novo sem uma mensagem de erro estável.

Como avaliar além de uma demo

Registre o request ID, a categoria de política, o status HTTP e o código de erro do fornecedor, sem gravar entradas sensíveis nos logs comuns.
Separe em mensagens distintas a recusa por política, o limite de requisições, a cota esgotada e a falha do modelo.
Não prometa que um fornecedor “nunca filtra”: políticas, modelos e regras por região mudam.
Ofereça uma rota alternativa permitida, mas mantenha as verificações de idade, consentimento e direitos.
Use apenas a política oficial vigente e o contrato como referência, e anote a data da revisão: um print de notícia ou um relato de fórum não são os termos atuais.
Mantenha uma política de produto que pode ser mais rígida que a do fornecedor: se o modelo permite, isso não significa que seu produto deva permitir.
Mantenha um conjunto fixo de regressão com casos de permitir, negar e escalar para revisão humana, e rode de novo a cada mudança de modelo ou política.

Opções do ModelRush para esse trabalho

No ModelRush, o Grok 4.6 é uma rota de texto e agentes: não é um endpoint de geração de imagens e não devolve imagem alguma.
Para um fluxo aberto de texto para imagem, use o Z-Image Spicy e guarde o ID do modelo e o resultado da revisão no mesmo registro da requisição.
Para modificar uma imagem que já existe, use o Qwen Image Edit Spicy em vez de disfarçar a edição como mais uma geração a partir de texto.

Um fluxo de produção reproduzível

Transforme moderated em um estado explícito. O gateway verifica a elegibilidade da conta e os direitos antes de enviar qualquer coisa ao fornecedor. Quando o fornecedor recusa, guarde um motivo normalizado e explique o próximo passo em vez de contornar automaticamente. Mostre uma rota de imagem alternativa do ModelRush somente quando o conteúdo é permitido e a falha diz respeito a capacidade ou disponibilidade. Reutilize uma chave de idempotência de negócio nas tentativas para que o usuário não pague duas vezes pelo mesmo trabalho.

O registro de roteamento guarda policy_version e provider_policy_checked_at junto da requisição. Depois de uma mudança de modelo ou de política, pause as rotas sensíveis e rode novamente o conjunto fixo de segurança antes de reabri-las. Quando a regra do fornecedor e a do produto divergem, vale a do produto e o motivo da recusa continua auditável. Já em produção, acompanhe três números: a taxa de aprovação da regressão de políticas, a distribuição de conteúdo que o fornecedor permite mas seu produto recusa, e o tempo entre uma mudança de política e sua aplicação real.

Perguntas frequentes

Moderated significa que a minha cota diária do Grok acabou?

Não necessariamente. Cota, limite de requisições e política de conteúdo são estados diferentes e precisam ser diagnosticados separadamente pela resposta e pelo estado da conta.

Trocar de modelo resolve automaticamente?

Só se a requisição for permitida e o problema for mesmo de capacidade ou disponibilidade. O roteamento nunca deve ser usado para contornar controles de abuso grave.

O aplicativo deve mostrar o erro original do fornecedor?

Guarde o erro original internamente para diagnóstico, mas mostre ao usuário uma explicação estável e acionável que não exponha detalhes demais da política interna.

Qual é a diferença entre moderação e limite de requisições?

A moderação diz respeito ao conteúdo daquela requisição: ela só passa se você mudar a entrada ou usar um modelo que permita. O limite de requisições diz respeito à frequência ou à cota: só volta quando a janela reinicia ou você reduz a concorrência. Os dois devem devolver códigos de erro e mensagens diferentes.

Se o modelo permite, o meu produto também deveria permitir?

Não necessariamente. O canal de distribuição, a idade dos usuários, a legislação local e o risco de marca são responsabilidade sua. Sua política pode ser mais rígida que a do modelo, e o motivo da recusa deve ficar registrado.

Confira a política de uso aceitável e o catálogo de modelos de imagem e projete os estados de política junto com as capacidades do modelo, em vez de deixar o usuário adivinhar.