Génération d’images

Créez des images à partir d’un prompt avec l’API Images d’OpenAI : Nano Banana, GPT Image, Grok Imagine et FLUX 3, un appel par modèle.

Créer une image

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..." }
  ]
}

Paramètres

Tailles

Le tarif de Nano Banana dépend de la résolution, et les images ont exactement la taille demandée : si une image générée est plus petite, la génération est relancée et l’image n’est jamais livrée. En 1K :

Grok Imagine génère environ un mégapixel en 1K et quatre en 2K, avec ses propres dimensions (1280 × 720 pour du 16:9 en 1K) ; si une image a un autre format ou une autre résolution, la génération est relancée et l’image n’est jamais livrée. Voir le guide Grok Imagine Image.

FLUX 3 génère environ un mégapixel en 1K, quatre en 2K et seize en 4K, dans 15 formats allant de 21:9 à 9:21 ; si une image est plus petite que demandé ou a un autre format, la génération est relancée et l’image n’est jamais livrée. Voir le guide FLUX 3.

GPT Image 2 coûte le même prix à toutes les tailles : 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. Le tarif de GPT Image 2.5 Flare et Sunburst dépend de la taille : jusqu’à 1024 × 1024 correspond à 1K, jusqu’à 2560 × 1440 à 2K, et au-delà à 4K. Sans taille spécifiée, ou avec auto, ils génèrent en 1024 × 1024.

Liens et historique

• Les liens dans url sont signés et restent valables 24 heures. Téléchargez ce que vous souhaitez conserver.
• Les images renvoyées sous forme de url sont aussi conservées pendant 30 jours dans la Bibliothèque de votre tableau de bord, où vous pouvez les télécharger, les supprimer ou les utiliser comme images de référence. Les images renvoyées sous forme de b64_json ne sont pas stockées.
• Chaque image stockée conserve le prompt qui l’a générée, affiché à côté dans le tableau de bord. L’image et le prompt sont supprimés au bout des mêmes 30 jours.

Délais

La plupart des images arrivent en 10 à 60 secondes, davantage en 4K. Si une tentative se bloque, la requête est automatiquement relancée par une autre voie ; prévoyez donc un délai d’expiration de 10 minutes côté client. Vous pouvez aussi ne pas attendre : ajoutez un callback_url et les images arrivent sur votre serveur dès qu’elles sont prêtes (voir Callbacks).

Lorsqu’une image n’est pas générée

Si le modèle refuse un prompt (par exemple, en raison de sa politique de contenu), vous recevez 400 image_not_generated avec le motif du refus, sans être facturé. Si n est supérieur à 1, vous recevez les images qui ont pu être générées et ne payez que celles-ci.