Geração de imagemns

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

Criar 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 depende da resolução e as imagemns têm exatamente o tamanho pedido: se uma imagem ficar mais pequena, a geração é repetida e essa imagem nunca é entregue. Em 1K:

O Grok Imagine cria imagens com cerca de um megapíxel em 1K e quatro em 2K, com dimensões próprias (1280 × 720 para 16:9 em 1K); se uma imagem tiver outra proporção ou resolução, a geração é repetida e essa imagem nunca é entregue. Consulte o guia do Grok Imagine Image.

O FLUX 3 cria imagens com cerca de um megapíxel em 1K, quatro em 2K e dezasseis em 4K, em 15 proporções de 21:9 a 9:21; se uma imagem for mais pequena do que o pedido ou tiver outra proporção, a geração é repetida e essa imagem nunca é entregue. Consulte o guia do FLUX 3.

O GPT Image 2 custa o mesmo em todos os tamanhos: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. O preço do GPT Image 2.5 Flare e Sunburst depende do tamanho: até 1024 × 1024 é 1K, até 2560 × 1440 é 2K e qualquer tamanho superior é 4K. Sem tamanho definido, ou com auto, criam imagens de 1024 × 1024.

Ligações e histórico

• As ligações em url são assinadas e funcionam durante 24 horas. Descarregue o que quiser guardar.
• As imagens devolvidas como url também ficam guardadas durante 30 dias na Biblioteca do painel, onde pode descarregá-las, eliminá-las ou usá-las como imagens de referência. As imagens devolvidas como b64_json não são guardadas.
• Cada imagem guardada mantém o prompt que a criou, apresentado ao lado da imagem no painel, e ambos são eliminados ao fim dos mesmos 30 dias.

Tempo de geração

A maioria das imagens fica pronta em 10 a 60 segundos, mas demora mais em 4K. Se uma tentativa ficar bloqueada, o pedido é repetido automaticamente por outra via, por isso defina um tempo limite de 10 minutos no cliente. Ou evite a espera: adicione um callback_url e as imagens chegam ao seu servidor quando estiverem prontas (consulte Callbacks).

Quando uma imagem não é criada

Se o modelo recusar um prompt (por exemplo, devido à sua política de conteúdo), recebe 400 image_not_generated com o motivo indicado pelo modelo e não paga nada. Com n superior a 1, recebe as imagens que foram criadas e paga apenas essas.