AIVAX

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; count aceita 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.net e 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, jpeg ou webp. 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 do jpeg ou webp. Não tem efeito no png. Quando a imagem é convertida e quality é 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.

Digite para pesquisar na documentação.