Geração de imagemns

Crie imagemns a partir de um prompt com a API de imagens da OpenAI: Nano Banana, GPT Image, Grok Imagine e FLUX 3, uma chamada para cada.

Crie uma imagem

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.generate(
    model="nano-banana-pro",
    prompt="A red fox curled up asleep in fresh snow at dawn, soft golden light, 85mm photo",
    size="2K",
    extra_body={
      "aspect_ratio": "3:2"
    },
)
print(result.data[0].url)

{
  "created": 1790870400,
  "data": [
    { "url": "https://...signed link, valid for 24 hours..." }
  ]
}

Parâmetros

Tamanhos

O preço do Nano Banana varia conforme a resolução, e ele gera exatamente o tamanho solicitado: se uma imagemm vier menor, a geração é refeita, e a imagem menor nunca é entregue. Em 1K:

O Grok Imagine gera cerca de um megapixel em 1K e quatro em 2K, em tamanhos próprios (1280 × 720 para 16:9 em 1K); se a imagem vier em outra proporção ou resolução, a geração é refeita, e essa imagem nunca é entregue. Veja o guia do Grok Imagine Image.

O FLUX 3 gera cerca de um megapixel em 1K, quatro em 2K e dezesseis em 4K, em 15 proporções de 21:9 a 9:21; se a imagem vier menor que o solicitado ou em outra proporção, a geração é refeita, e essa imagem nunca é entregue. Veja o guia do FLUX 3.

O GPT Image 2 custa o mesmo em qualquer tamanho: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. Os preços do GPT Image 2.5 Flare e Sunburst variam conforme o tamanho: até 1024 × 1024 é 1K, até 2560 × 1440 é 2K, e acima disso é 4K. Sem tamanho definido, ou com auto, eles geram em 1024 × 1024.

Links e histórico

• Os links em url são assinados e funcionam por 24 horas. Baixe o que quiser guardar.
• As imagens retornadas como url também ficam por 30 dias na Biblioteca do seu painel, onde você pode baixá-las, excluí-las ou usá-las como referência. As imagens retornadas como b64_json não são armazenadas.
• Cada imagem armazenada mantém o prompt que a gerou, exibido ao lado dela no painel, e ambos são excluídos após os mesmos 30 dias.

Tempo de geração

A maioria das imagens chega em 10 a 60 segundos, e demora mais em 4K. Se uma tentativa travar, a requisição é refeita automaticamente por outra rota, então configure um timeout de 10 minutos no seu cliente. Ou não espere: adicione um callback_url e as imagens chegam ao seu servidor quando estiverem prontas (veja Callbacks).

Quando uma imagem não é gerada

Se o modelo recusar um prompt (por exemplo, por sua política de conteúdo), você recebe 400 image_not_generated com o motivo informado pelo modelo, e não há cobrança. Com n acima de 1, você recebe as imagens que foram geradas e paga apenas por elas.