Geração de Imagens

Use a Geração de Imagens para criar imagens a partir de um prompt de texto em um fluxo de trabalho de aplicação. Os usos típicos incluem ilustrações preliminares para revisão editorial, maquetes de produtos, variações de marketing para testes A/B e arte de espaço reservado que um designer refina posteriormente.

Autentique solicitações com uma chave de API AIVAX. Consulte Authentication para orientações de autorização.

Escolha um modelo #

Selecione um modelo de geração de imagens disponível para a conta autenticada. A disponibilidade e as capacidades dos modelos podem mudar, portanto obtenha as opções atuais na plataforma em vez de depender de uma lista fixa neste guia.

Quando vários modelos estão disponíveis, decida por capacidade: se você precisa de suporte a imagens de referência (apenas alguns modelos aceitam referenceImages), quantas variações por prompt você precisa (count aceita de 1 a 4) e quanto tempo sua aplicação pode aguardar — solicitações de imagem em alguns modelos demoram, caso em que a API recomenda direct.inference.aivax.net.

Gerar uma imagem #

Use prompts que indiquem o resultado desejado em vez de confiar em rótulos visuais vagos. Inclua os detalhes importantes, como o assunto, ambiente, enquadramento e qualquer texto que deve estar presente. Uma solicitação pode conter um único prompt ou um array de prompts, e cada prompt gera count imagens cujas URLs são retornadas agrupadas pelo prompt de entrada.

Forneça até quatro imagens de referência HTTP(S) quando o modelo selecionado as suportar e a saída deve seguir um assunto, estilo ou composição existente. As referências orientam o resultado; elas não garantem a preservação da identidade, portanto inspecione a saída antes de publicar.

Trate os ativos gerados como rascunhos e revise-os quanto à precisão, adequação à marca e conteúdo não intencional antes do lançamento. Quando o primeiro resultado estiver próximo, mas não correto, itere apertando um elemento de cada vez — detalhe do assunto, composição, restrição de estilo — ao invés de reescrever todo o prompt de uma vez.

A referência incorporada é a fonte de verdade para a estrutura da solicitação, opções suportadas e campos de resposta.

Para permitir que um agente ou IDE compatível com MCP gere imagens sem chamar este endpoint diretamente, use o Media generation MCP.

Preços, limites e erros #

A geração de imagens é cobrada por imagem entregue, com uma cobrança adicional por imagem de referência em alguns modelos. Saídas falhas ou não entregues não são cobradas. Consulte Pricing para saber como a cobrança é calculada e o catálogo de Modelos para a tarifa de cada modelo.

Para disponibilidade e limites da conta, veja Plans and Limits. Se uma solicitação falhar, revise o problema de validação relatado antes de tentar novamente.