Generación de imágenes

Crea imágenes a partir de un prompt con la API de Images de OpenAI: Nano Banana, GPT Image, Grok Imagine y FLUX 3, una llamada cada uno.

Crear una imagen

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

Tamaños

Nano Banana se cobra por resolución y genera exactamente el tamaño solicitado: una imagenn que vuelve más pequeña se reintenta y nunca se entrega. En 1K:

Grok Imagine genera aproximadamente un megapíxel en 1K y cuatro en 2K, con tamaños propios (1280 × 720 para 16:9 en 1K); una imagen con otra forma u otra resolución se reintenta y nunca se entrega. Consulta la guía de Grok Imagine Image.

FLUX 3 genera aproximadamente un megapíxel en 1K, cuatro en 2K y dieciséis en 4K, en 15 formas de 21:9 a 9:21; una más pequeña de lo solicitado, o con otra forma, se reintenta y nunca se entrega. Consulta la guía de FLUX 3.

GPT Image 2 cuesta lo mismo en cualquier tamaño: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. GPT Image 2.5 Flare y Sunburst se cobran por tamaño: hasta 1024 × 1024 es 1K, hasta 2560 × 1440 es 2K y cualquier tamaño mayor es 4K. Si no se pide tamaño, o se pide auto, generan 1024 × 1024.

Enlaces e historial

• Los enlaces en url están firmados y funcionan durante 24 horas. Descarga lo que quieras conservar.
• Las imágenes devueltas como url también se guardan 30 días en la Biblioteca de tu panel, donde puedes descargarlas, eliminarlas o usarlas como imágenes de referencia. Las imágenes devueltas como b64_json no se almacenan.
• Cada imagen guardada conserva el prompt que la generó, que se muestra junto a ella en el panel, y ambos se eliminan tras los mismos 30 días.

Tiempos

La mayoría de las imágenes llegan en 10 a 60 segundos, y más tarde en 4K. Si un intento se atasca, la solicitud se reintenta automáticamente por otra ruta, así que configura en tu cliente un tiempo de espera de 10 minutos. O no esperes en absoluto: añade un callback_url y las imágenes llegarán a tu servidor cuando estén listas (consulta Callbacks).

Cuando no se genera una imagen

Si el modelo rechaza un prompt (por ejemplo, por su política de contenido), recibes 400 image_not_generated con el motivo del modelo y no se te cobra. Con n mayor que 1, recibes las imágenes que sí se generaron y pagas solo por ellas.