Bildgenerierung

Erstelle Bilder aus einem Prompt mit der Images API von OpenAI: Nano Banana, GPT Image, Grok Imagine und FLUX 3, jeweils mit einem Aufruf.

Bild erstellen

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

Parameter

Größen

Der Preis für Nano Banana richtet sich nach der Auflösung. Es erzeugt genau die angeforderte Größe: Ist ein Bild kleiner, wird der Versuch wiederholt und das Bild nicht ausgeliefert. Bei 1K:

Grok Imagine erzeugt bei 1K etwa ein Megapixel und bei 2K etwa vier Megapixel, in eigenen Bildgrößen (1280 × 720 für 16:9 bei 1K). Hat ein Bild eine andere Form oder Auflösung, wird der Versuch wiederholt und das Bild nicht ausgeliefert. Siehe den Grok Imagine Image Guide.

FLUX 3 erzeugt bei 1K etwa ein Megapixel, bei 2K vier und bei 4K sechzehn, in 15 Formen von 21:9 bis 9:21. Ist ein Bild kleiner als angefordert oder hat es eine andere Form, wird der Versuch wiederholt und das Bild nicht ausgeliefert. Siehe den FLUX 3 Guide.

GPT Image 2 kostet bei jeder Größe gleich viel: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 3840x2160, 2160x3840. Die Preise für GPT Image 2.5 Flare und Sunburst richten sich nach der Größe: bis 1024 × 1024 gilt als 1K, bis 2560 × 1440 als 2K und alles darüber als 4K. Ohne Größenangabe oder mit auto erzeugen sie 1024 × 1024.

Links und Verlauf

• Links in url sind signiert und funktionieren 24 Stunden lang. Lade herunter, was du behalten möchtest.
• Bilder, die als url zurückgegeben werden, bleiben außerdem 30 Tage in der Bibliothek deines Dashboards. Dort kannst du sie herunterladen, löschen oder als Referenzbilder verwenden. Bilder, die als b64_json zurückgegeben werden, werden nicht gespeichert.
• Zu jedem gespeicherten Bild bleibt der Prompt erhalten, mit dem es erstellt wurde. Er wird im Dashboard neben dem Bild angezeigt. Beide werden nach denselben 30 Tagen gelöscht.

Dauer

Die meisten Bilder sind nach 10 bis 60 Sekunden fertig, bei 4K dauert es länger. Wenn ein Versuch hängen bleibt, wird die Anfrage automatisch über einen anderen Weg wiederholt. Setze das Timeout deines Clients daher auf 10 Minuten. Oder warte gar nicht: Füge callback_url hinzu, dann kommen die Bilder auf deinem Server an, sobald sie fertig sind (siehe Callbacks).

Wenn kein Bild erstellt wird

Lehnt das Modell einen Prompt ab (etwa wegen seiner Inhaltsrichtlinien), erhältst du 400 image_not_generated mit der Begründung des Modells und zahlst nichts. Bei n über 1 erhältst du die erstellten Bilder und zahlst nur für diese.