Pular para o conteúdo
Cheapest Imagen
Guias

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

CampoO que fazValores
nNúmero de imagens1 a 10, padrão 1
sizeLargura e alturaauto ou um tamanho de 1K, 2K ou 4K, veja Proporções e tamanhos
qualityQualidade da renderização, mesmo preço para todasauto, low, medium, high; xhigh, max no gpt-image-2.5-sunburst
backgroundFundo transparente ou sólidoauto, opaque, transparent
output_formatFormato do arquivopng (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_compressionQualidade de jpeg e webp0 a 100, padrão 100
moderationRigor da verificação de conteúdoauto, low
response_formatDados da imagem ou um linkb64_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.

ModeloPNGJPEGWebPGIFSVG
gpt-image-2, gpt-image-2.5, gpt-image-2-adobeSimSimSim––
gpt-image-2.6SimSimSimSimSim
gpt-image-2.5-flare, gpt-image-2.5-sunburstSimSimSim––
gpt-image-2.6-flare, gpt-image-2.6-sunburstSimSimSimSim–
Nano Banana (todas as versões)SimSimSim––

“–” 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.

Nesta página