O que é uma API de geração de imagens com IA?

É um endpoint HTTP que transforma uma descrição escrita em uma imagem. Você envia um prompt como JSON e o serviço devolve as imagens geradas na resposta, o que permite a um produto oferecer texto para imagem sem rodar nenhuma infraestrutura de modelos própria.

Quantas imagens posso gerar por requisição?

Entre uma e quatro, com o parâmetro samples. Todas as imagens solicitadas voltam em um único array images dentro da mesma resposta.

Quais modelos estão disponíveis?

Três: imggen-base é o padrão e equilibra qualidade e velocidade, imggen-base-fast devolve resultados mais rápido com menos detalhe e imggen-xl mira a maior qualidade. Você escolhe por requisição com o parâmetro model.

Quais proporções são aceitas?

square, portrait e landscape, com o parâmetro aspect_ratio. Se você omitir, o padrão é square.

Quanto custa a geração de imagens?

A geração é cobrada por modelo e não a uma taxa fixa, porque os modelos diferem bastante em processamento. Começa em 3 créditos por imagem no modelo padrão e sobe nos de maior qualidade. Seu saldo restante volta no cabeçalho X-Credit-Remaining de toda chamada bem-sucedida, e o custo atual de cada modelo aparece na sua conta ImgGen.

De quem são as imagens geradas pela API?

Suas. A ImgGen não reivindica a propriedade de nada que a API devolve, e todos os planos trazem direitos de uso comercial completos e sem marca d'água. Tenha em mente que os direitos autorais sobre imagens geradas por IA são tratados de forma diferente em cada jurisdição, então se a propriedade for juridicamente decisiva no seu caso, verifique a situação local.

Posso usar comercialmente as imagens geradas?

Sim. Todos os planos, inclusive o gratuito, incluem direitos de uso comercial completos, e nenhum resultado leva marca d'água. Você pode vender, imprimir ou publicar qualquer coisa que a API devolver.

Vocês armazenam prompts ou imagens geradas?

As imagens geradas são devolvidas na resposta e não são retidas. Como em todos os endpoints da ImgGen, a única coisa guardada é um registro de uso anotando que houve uma chamada e quanto ela custou. Seu conteúdo não é usado para treinar modelos.

a partir de 3 créditos por chamada

API de geração de imagens com IA

Gere imagens a partir de um prompt de texto com uma única requisição JSON. Até quatro amostras por chamada, três modelos para equilibrar velocidade e qualidade, e direitos comerciais completos sobre o resultado.

REST · JSON
Sem marca d'água
Nada é armazenado

Obtenha sua chave de API Ver a documentação

endpoint

POST /v1/generate-image

URL base: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Custo: a partir de 3 créditos
Entrada: JPEG (JPG), PNG and WebP · max 25 MB

01 — Visão geral

O que é a API de geração de imagens com IA?

A API de geração de imagens da ImgGen AI é um endpoint REST que transforma um prompt de texto em imagens. Você envia um corpo JSON com o prompt, quantas amostras quer, uma proporção e qual modelo usar; o endpoint devolve as imagens geradas codificadas em base64 dentro de um array. É o único endpoint que recebe JSON em vez de um arquivo.

É um dos sete endpoints da API de edição de imagens da ImgGen AI, que compartilham uma única chave de API, uma única URL base e o mesmo formato de requisição e resposta. Se você também precisa desse recurso no navegador e não a partir de código, o mesmo modelo de IA move a ferramenta AI Image Generator.

02 — Requisição

Parâmetros da requisição

Envie uma requisição POST para https://app.imggen.ai/v1/generate-image, autenticada com uma chave de API no cabeçalho Authorization.

Parâmetros aceitos por este endpoint
Parâmetro	Tipo	Obrigatório	Padrão	Descrição
prompt	string	OBRIGATÓRIO	—	Descrição em texto da imagem a ser gerada.
samples	number	opcional	1	Quantas imagens gerar, de 1 a 4.
aspect_ratio	string	opcional	square	Formato da saída. Aceita square, portrait ou landscape.
model	string	opcional	imggen-base	Modelo de geração. Aceita imggen-base, imggen-base-fast ou imggen-xl.

03 — Integração

Como integro a API de geração de imagens com IA?

Crie uma chave de API na sua conta ImgGen, salve-a como variável de ambiente e chame o endpoint. Esta é a mesma requisição em cURL, Node.js e Python.

curl --request POST \
  --url 'https://app.imggen.ai/v1/generate-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "close up photo of a rabbit in a wildflower meadow",
    "samples": 1,
    "aspect_ratio": "square",
    "model": "imggen-base"
  }'

import fs from 'node:fs';

const res = await fetch('https://app.imggen.ai/v1/generate-image', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'close up photo of a rabbit in a wildflower meadow',
    samples: 1,
    aspect_ratio: 'square',
    model: 'imggen-base',
  }),
});

const data = await res.json();
data.images.forEach((img, i) =>
  fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);

import base64, os, requests

res = requests.post(
    "https://app.imggen.ai/v1/generate-image",
    headers={
        "Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "close up photo of a rabbit in a wildflower meadow",
        "samples": 1,
        "aspect_ratio": "square",
        "model": "imggen-base",
    },
)

for i, img in enumerate(res.json()["images"]):
    with open(f"image-{i}.png", "wb") as out:
        out.write(base64.b64decode(img))

04 — Resposta

Resposta

Uma chamada bem-sucedida devolve JSON. O resultado vem codificado em base64 — decodifique antes de gravar em disco ou no seu armazenamento de objetos. Toda resposta bem-sucedida traz ainda um cabeçalho X-Credit-Remaining com seu saldo após a chamada.

{
  "success": true,
  "message": "Images generated successfully",
  "images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}

05 — Limites

Limites e comportamentos que vale conhecer

O endpoint aceita JPEG (JPG), PNG e WebP com tamanho máximo de arquivo de 25 MB e responde de forma síncrona em até 60 segundos — não há job para consultar nem webhook para configurar.

Devolve um array images

Diferente dos endpoints de edição, que devolvem um único campo image, a geração devolve images — um array com uma entrada por amostra solicitada.

Três modelos

imggen-base é o equilíbrio padrão, imggen-base-fast troca detalhe por velocidade e imggen-xl mira a maior qualidade. A escolha é por requisição, não por conta.

JSON, não multipart

É o único endpoint que recebe um corpo JSON. Envie Content-Type: application/json em vez de um formulário multipart.

06 — Em produção

Para que serve a API de geração de imagens com IA?

Onde as equipes colocam este endpoint em produção para processar imagens de forma programática e em escala.

Imagens editoriais e de blog

Gere uma imagem de capa original para cada artigo a partir do título, em vez de recorrer a um banco de imagens que todo mundo usa.

Conceituação de produto e campanhas

Produza quatro variações de uma ideia visual em uma só chamada para que o time escolha uma direção antes de encomendar o trabalho real.

Recursos criativos dentro do app

Deixe seus usuários gerarem imagens dentro do seu produto sem que você precise montar infraestrutura de GPU.

Conteúdo de preenchimento e maquetes

Preencha demos, protótipos e ambientes de teste com imagens verossímeis geradas sob demanda.

07 — Custo

Quanto custa a API de geração de imagens com IA?

Cada chamada bem-sucedida custa a partir de 3 créditos, então seu custo real por imagem depende do plano que você tem. Os créditos vêm do seu plano e são compartilhados entre todos os endpoints e o editor web, de modo que você não compra uma cota separada por ferramenta. Uma chamada que falha é reembolsada automaticamente. Veja todos os detalhes na página de preços.

Planos da ImgGen AI e acesso à API
Plano	Preço	Créditos	API
Free	$0	50 créditos gratuitos únicos	Sem acesso à API
Starter	$9.99 / month	400 créditos / mês	Acesso à API incluído
Pro	$29.99 / month	1.400 créditos / mês	Acesso à API + suporte prioritário
Enterprise	Custom	Volume personalizado	Infraestrutura dedicada

Custos em créditos e limites verificados pela última vez em 2026-08-27.

08 — Relacionado

As equipes que usam a API de geração de imagens com IA costumam recorrer a estes em seguida.

→API de remoção de fundo →API de ampliação de imagens AI Image Generator (ferramenta web)Todos os endpoints da API

Também disponíveis: Remoção de marca d'água, Remoção de texto, Restauração de fotos, Colorização de fotos.

FAQ

Perguntas frequentes sobre a API de geração de imagens com IA

: É um endpoint HTTP que transforma uma descrição escrita em uma imagem. Você envia um prompt como JSON e o serviço devolve as imagens geradas na resposta, o que permite a um produto oferecer texto para imagem sem rodar nenhuma infraestrutura de modelos própria.
: Entre uma e quatro, com o parâmetro samples. Todas as imagens solicitadas voltam em um único array images dentro da mesma resposta.
: Três: imggen-base é o padrão e equilibra qualidade e velocidade, imggen-base-fast devolve resultados mais rápido com menos detalhe e imggen-xl mira a maior qualidade. Você escolhe por requisição com o parâmetro model.
: square, portrait e landscape, com o parâmetro aspect_ratio. Se você omitir, o padrão é square.
: A geração é cobrada por modelo e não a uma taxa fixa, porque os modelos diferem bastante em processamento. Começa em 3 créditos por imagem no modelo padrão e sobe nos de maior qualidade. Seu saldo restante volta no cabeçalho X-Credit-Remaining de toda chamada bem-sucedida, e o custo atual de cada modelo aparece na sua conta ImgGen.
: Suas. A ImgGen não reivindica a propriedade de nada que a API devolve, e todos os planos trazem direitos de uso comercial completos e sem marca d'água. Tenha em mente que os direitos autorais sobre imagens geradas por IA são tratados de forma diferente em cada jurisdição, então se a propriedade for juridicamente decisiva no seu caso, verifique a situação local.
: Sim. Todos os planos, inclusive o gratuito, incluem direitos de uso comercial completos, e nenhum resultado leva marca d'água. Você pode vender, imprimir ou publicar qualquer coisa que a API devolver.
: As imagens geradas são devolvidas na resposta e não são retidas. Como em todos os endpoints da ImgGen, a única coisa guardada é um registro de uso anotando que houve uma chamada e quanto ela custou. Seu conteúdo não é usado para treinar modelos.

Começar

Comece a chamar a API de geração de imagens com IA

Uma única chave libera os sete endpoints. Sem marca d'água, com direitos comerciais completos e sem que nada do que você envia seja armazenado depois que a resposta é devolvida.

Obtenha sua chave de API