Esta página foi traduzida automaticamente do inglês e pode estar desatualizada. Leia o original
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 aplicativo. Os usos típicos incluem ilustrações preliminares para revisão editorial, mockups de produtos, variações de marketing para testes A/B e arte de preenchimento que um designer refinaria posteriormente.
Autentique as solicitações com uma chave de API da AIVAX. Consulte Autenticação para orientações sobre autorização.
Escolha um modelo #
Selecione um modelo de geração de imagem disponível para a conta autenticada. A disponibilidade e as capacidades dos modelos podem mudar, portanto, obtenha as opções atuais diretamente na plataforma em vez de depender de uma lista fixa neste guia.
Quando vários modelos estiverem disponíveis, compare-os por capacidade:
- Imagens de referência: apenas alguns modelos aceitam
referenceImages. - Variações: decida quantas imagens você precisa por prompt;
countaceita valores de 1 a 4. - Tempo de espera: as solicitações de imagem em alguns modelos demoram um pouco. Para esses casos, envie a solicitação para
https://direct.inference.aivax.nete aumente o tempo limite do cliente, conforme descrito em inferência de longa duração.
Gerar uma imagem #
Use prompts que descrevam o resultado necessário em vez de depender de rótulos visuais vagos. Inclua os detalhes importantes, como o assunto, o ambiente, o enquadramento e qualquer texto que deva estar presente. Uma solicitação pode conter um único prompt ou um array de prompts. Cada prompt gera count imagens, e seus URLs retornam agrupados pelo prompt de entrada.
Controle a saída com estes campos opcionais:
size: as dimensões da imagem, seja como uma string"1024x1024"ou como{ "width": 1024, "height": 1024 }. Cada lado deve ter entre 64 e 4096 pixels. O padrão é 1080×1920. O modelo pode ajustar o tamanho para dimensões que suporta, então verifique a imagem entregue.format:png,jpegouwebp. Quando omitido, a imagem mantém o formato produzido pelo modelo.quality: um inteiro de 1 a 100 que define a qualidade de codificação dojpegouwebp. Não tem efeito nopng. Quando a imagem é convertida equalityé omitido, usa-se 90.
Cada grupo de prompt retorna images, os URLs das imagens entregues, e outputs, uma entrada por imagem solicitada na ordem da solicitação. Cada entrada contém o url da imagem, o cost cobrado por ela e, quando falhou, uma mensagem de error com um URL nulo. O cost do grupo é a soma cobrada para aquele prompt. Uma solicitação pode ser bem-sucedida mesmo com algumas imagens falhas, então verifique outputs em vez de assumir que images possui count entradas.
Forneça até quatro imagens de referência HTTP(S) quando o modelo selecionado suportá-las e a saída precisar seguir um assunto, estilo ou composição existentes. As referências guiam o resultado; elas não garantem a preservação exata da identidade, então 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 indesejado antes do lançamento. Quando o primeiro resultado está próximo, mas não está correto, itere ajustando um elemento de cada vez — detalhe do assunto, composição, restrição de estilo — em vez de reescrever todo o prompt de uma vez.
A referência embutida é a fonte da verdade para a forma da solicitação, as opções suportadas e os 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. Para uma configuração do Claude Code, consulte gerar imagens no Claude Code com um servidor 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. Cada saída é precificada pela tarifa fixa de saída do modelo selecionado, mais a tarifa por referência desse modelo para cada imagem de referência enviada junto. O processamento do prompt está incluído. Para provedores que cobram por token e megapixel, a cobrança utiliza estimativas arredondadas para cima, em vez de repasse exato do custo do provedor. Não há markup adicional de geração de imagens da AIVAX nem multiplicador de conta e plano aplicáveis. As tarifas atuais para cada modelo estão listadas no catálogo de Modelos.
A ferramenta integrada de geração e edição de imagens possui um limite diário que depende do plano; consulte Limites de ferramentas integradas e pesquisa web.
Se uma solicitação falhar, revise o problema de validação relatado antes de tentar novamente.
