Texto para imagem
Gere imagens a partir de um prompt de texto com a API do Cheapest Imagen e escolha o modelo, o tamanho, a qualidade, o número de imagens e o formato do arquivo.
Envie um prompt para POST /v1/images/generations. Só model e prompt são obrigatórios.
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'Opções
| Campo | O que faz | Valores |
|---|---|---|
n | Número de imagens | 1 a 10, padrão 1 |
size | Largura e altura | auto ou um tamanho de 1K, 2K ou 4K, veja Proporções e tamanhos |
quality | Qualidade da renderização, mesmo preço para todas | auto, low, medium, high; xhigh, max no gpt-image-2.5-sunburst |
background | Fundo transparente ou sólido | auto, opaque, transparent |
output_format | Formato do arquivo | png (padrão), jpeg, webp em todos os modelos; gif no gpt-image-2.6 e nas versões flare e sunburst; svg no gpt-image-2.6 |
output_compression | Qualidade de jpeg e webp | 0 a 100, padrão 100 |
moderation | Rigor da verificação de conteúdo | auto, low |
response_format | Dados da imagem ou um link | b64_json (padrão), url |
No momento, nenhum modelo gera fundo transparente: a OpenAI retirou a prévia de transparência dos modelos GPT Image, e eles agora devolvem fundo sólido. Uma requisição com background: transparent retorna 400 com o código unsupported_parameter. Para obter um recorte, peça no prompt um fundo liso de uma só cor e remova-o depois.
Formatos de saída
PNG, JPEG e WebP funcionam em todos os modelos, como na API da OpenAI. A maioria dos modelos gera PNG, e nós convertemos para o JPEG ou WebP pedido dentro da rede da Cloudflare (cerca de 0,1 a 0,4 segundo; um PNG de 2 MB vira um JPEG ou WebP de cerca de 250 KB). gpt-image-2.6-flare e gpt-image-2.6-sunburst geram JPEG e WebP diretamente.
| Modelo | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | Sim | Sim | Sim | – | – |
gpt-image-2.6 | Sim | Sim | Sim | Sim | Sim |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | Sim | Sim | Sim | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | Sim | Sim | Sim | Sim | – |
| Nano Banana (todas as versões) | Sim | Sim | Sim | – | – |
“–” retorna 400. output_compression define a qualidade de JPEG ou WebP em todos os modelos (padrão 100). Um GIF pode levar de três a cinco minutos. O tipo real do arquivo está na extensão do link e no Content-Type.
Quantos créditos uma requisição usa
Uma requisição usa n vezes os créditos do modelo: 8 por imagem no GPT Image 2, 2.5 e 2.6, 12 no Nano Banana 2 e 2.1, 20 no Nano Banana Pro, no gpt-image-2-adobe e nas versões flare, 25 nas versões sunburst, de 60 a 180 nos canais estáveis do Nano Banana. Se voltarem menos imagens do que você pediu, você paga só pelas que recebeu.
Enviar a mesma requisição duas vezes
Adicione um cabeçalho Idempotency-Key com um valor à sua escolha. Se a mesma chave chegar de novo enquanto a primeira requisição está em andamento ou depois de ela ter dado certo, a API responde 409 e não gera nem cobra outra vez. Depois de uma requisição que falhou, você pode reutilizar a chave.
Início rápido
Gere sua primeira imagem com IA pela API do Cheapest Imagen em três passos: crie uma chave, envie uma requisição e leia a imagem na resposta.
Modelos
Todos os ids de modelo da API do Cheapest Imagen, com o modelo oficial da OpenAI ou do Google que cada um executa, as resoluções que gera e os créditos por imagem.