Gerar Imagem
O que esta ferramenta faz
Section titled “O que esta ferramenta faz”Gerar Imagem com LLM é a ferramenta nativa que transforma uma descrição em imagem durante uma conversa. O agente decide quando chamá-la, envia ao modelo de imagem uma descrição detalhada em inglês e, quando a geração funciona, recebe uma URL para incluir na resposta em Markdown.
Use-a para criativos, capas, mockups, ilustrações, avatares e outros fluxos em que a resposta final precisa de um visual. Ela não transforma HTML em imagem; para isso, consulte HTML para Imagem.
Quem pode configurar
Section titled “Quem pode configurar”A pessoa precisa conseguir editar o agente (agents.write). A permissão de
time Gerar imagens controla o modo manual de imagem do Hub; ela não desativa
esta ferramenta nativa em conversas atendidas pelo agente.
Como configurar
Section titled “Como configurar”- Abra o agente e entre em Ferramentas.
- Selecione Adicionar Ferramenta.
- Em Ferramentas Nativas, escolha Gerar Imagem com LLM.
- No painel Gerar imagens, selecione o Modelo de imagem.
A escolha é salva assim que o modelo é selecionado. Sem image_model_id, o
cartão permanece com o aviso amarelo de configuração e a ferramenta não é
oferecida ao agente.
O seletor mostra modelos globais marcados como ativos e compatíveis com geração de imagem. Configurações → Modelos de IA é um catálogo de consulta, com capacidades e estimativas; não é onde modelos são ativados para a organização. Se a lista estiver vazia, um administrador comum não consegue ativar um modelo: encaminhe o caso ao suporte ou ao administrador da plataforma.
O produto hoje não aplica corretamente o catálogo do plano nesse seletor e não revalida atividade, capacidade ou entitlement durante a execução. Até essa inconsistência ser corrigida, confirme com o responsável pelo plano se o modelo selecionado deve estar disponível para a organização.
Como orientar o agente
Section titled “Como orientar o agente”O agente escolhe se deve chamar a ferramenta. Escreva no prompt do agente:
- em quais pedidos a imagem deve ser gerada;
- quais informações precisam ser coletadas antes da geração;
- estilo, público, composição, texto visível e elementos proibidos;
- que não deve repetir a chamada para o mesmo pedido após receber sucesso.
O contrato aceita prompt como campo obrigatório e aspectRatio como opcional.
As proporções aceitas são:
| Valor | Uso comum |
|---|---|
1:1 | quadrado; também é o padrão quando a proporção é omitida |
16:9 | paisagem |
9:16 | retrato vertical |
4:3 | paisagem tradicional |
3:4 | retrato tradicional |
O suporte efetivo a uma proporção ainda depende do modelo escolhido. Se o provedor rejeitar o pedido, a ferramenta devolve erro ao agente.
Entrega e armazenamento
Section titled “Entrega e armazenamento”Em caso de sucesso, a ferramenta retorna status, imageUrl e aspectRatio.
O agente é instruído a inserir  na própria resposta. No
Hub isso é renderizado como imagem; em canais externos, o pipeline pode separar
essa referência para entrega como mídia.
Portanto, a imagem não é um anexo automático independente da resposta: a
entrega depende de o agente usar a URL retornada. O arquivo fica no bucket
público generated-images, em uma URL permanente e sem expiração. Qualquer
pessoa com a URL pode acessá-lo; não use a ferramenta para material sigiloso.
A limpeza conhecida ocorre no encerramento da organização, não ao encerrar ou
arquivar uma conversa.
Créditos e falhas
Section titled “Créditos e falhas”Uma geração concluída adiciona o custo ao mesmo turno do assistente. Quando o provedor informa o custo real, esse valor tem prioridade; a tabela local é fallback. Com chave OpenRouter própria, o produto aplica o crédito operacional previsto para BYOK. Consulte Modelos de Imagem para estimativas e acompanhe o saldo em Configurações → Assinatura.
Em caso de falha, a ferramenta devolve status: "error" e orienta o agente a
explicar o problema sem tentar novamente sozinho. Uma nova tentativa deve ser
uma decisão explícita, especialmente porque o provedor pode já ter processado
uma geração antes de uma falha de armazenamento ou contabilização.
Checklist de validação
Section titled “Checklist de validação”- teste pedidos que devem e que não devem gerar imagem;
- confira se o agente coletou contexto suficiente antes da chamada;
- valide as proporções necessárias com o modelo selecionado;
- confirme que a resposta final contém e renderiza a imagem;
- trate a URL como pública e monitore créditos após publicar.