Afbeeldingen genereren

Maak afbeeldingen op basis van een prompt met de Images API van OpenAI: Nano Banana, GPT Image, Grok Imagine en FLUX 3, elk met één aanroep.

Maak een afbeelding

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

Parameters

Formaten

Bij Nano Banana hangt de prijs af van de resolutie en krijg je precies het gevraagde formaat: als een afbeelding kleiner uitvalt, wordt de poging herhaald en de kleinere afbeelding nooit geleverd. Bij 1K:

Grok Imagine maakt ongeveer één megapixel bij 1K en vier bij 2K, met eigen afmetingen (1280 × 720 voor 16:9 bij 1K); als een afbeelding een andere beeldverhouding of resolutie heeft, wordt de poging herhaald en die afbeelding nooit geleverd. Zie de Grok Imagine Image-handleiding.

FLUX 3 maakt ongeveer één megapixel bij 1K, vier bij 2K en zestien bij 4K, in 15 beeldverhoudingen van 21:9 tot 9:21; als een afbeelding kleiner is dan gevraagd of een andere beeldverhouding heeft, wordt de poging herhaald en die afbeelding nooit geleverd. Zie de FLUX 3-handleiding.

GPT Image 2 kost op elk formaat hetzelfde: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. Bij GPT Image 2.5 Flare en Sunburst hangt de prijs af van het formaat: tot en met 1024 × 1024 is 1K, tot en met 2560 × 1440 is 2K en alles daarboven is 4K. Als je geen formaat opgeeft, of auto, maken ze 1024 × 1024.

Links en geschiedenis

• Links in url zijn ondertekend en werken 24 uur. Download wat je wilt bewaren.
• Afbeeldingen die als url worden teruggegeven, blijven ook 30 dagen bewaard in de Bibliotheek van je dashboard. Daar kun je ze downloaden, verwijderen of als referentieafbeeldingen gebruiken. Afbeeldingen die als b64_json worden teruggegeven, worden niet opgeslagen.
• Bij elke opgeslagen afbeelding wordt de gebruikte prompt bewaard en ernaast getoond in het dashboard. Beide worden na dezelfde 30 dagen verwijderd.

Doorlooptijd

De meeste afbeeldingen zijn binnen 10 tot 60 seconden klaar, bij 4K duurt het langer. Als een poging vastloopt, wordt het verzoek automatisch via een andere route opnieuw geprobeerd. Stel de time-out van je client daarom in op 10 minuten. Of wacht helemaal niet: voeg een callback_url toe en de afbeeldingen worden naar je server gestuurd zodra ze klaar zijn (zie Callbacks).

Als een afbeelding niet wordt gemaakt

Als het model een prompt weigert (bijvoorbeeld vanwege het inhoudsbeleid), krijg je 400 image_not_generated met de reden van het model en betaal je niets. Als n hoger is dan 1, krijg je de afbeeldingen die wel zijn gemaakt en betaal je alleen daarvoor.