- Text zu Bild.
- Bild zu Bild mit Referenz-Assets.
- OpenAI-kompatible Bildgenerierung.
- OpenAI-kompatible Bildbearbeitung.
- Gemini-kompatible Bild-Workflows.
/v1/images/generations bevorzugen und /v1/tasks/{task_id} abfragen.
Verfügbare Modelle
GPT Image 2.6 — PNG und animierte GIFs
Mit der öffentlichen Modell-IDgpt-image-2.6 fordern Sie ein PNG-Standbild oder eine herunterladbare animierte GIF-Datei an. Jede erfolgreiche Anfrage liefert ein Ergebnis und kostet in beiden Formaten 30 Credits. Prüfen Sie vor der Nutzung die Verfügbarkeit in GET /v1/models; Beispiele garantieren keine aktuelle Freischaltung.
Unterstützte Anfrageparameter
output_format:png(Standard) odergif.quality: nurauto.resolution: nur1K.n: nur1.size:auto,1:1,3:2,2:3,1024x1024,1536x1024oder1024x1536.image_urls: höchstens ein Referenzbild. Dies ist die aktuelle APIAny.AI-Grenze für dieses Modell. Für reine Textgenerierung lassen Sie das Feld weg.
frame_count noch frame_duration_ms. SVG, JPEG, WebP, 2K/4K, Masken und Ausgabekompression werden nicht unterstützt. background akzeptiert aus Kompatibilitätsgründen nur auto und kann entfallen. Nicht unterstützte Werte, einschließlich SVG, führen zu HTTP 400; SVG wird nicht stillschweigend durch PNG ersetzt.
Diese Grenzen gelten auch für Kompatibilitätsaliase auf oberster Ebene und in model_params. Widersprüchliche Werte führen zu HTTP 400. Verwenden Sie bevorzugt die unten gezeigten Standardfelder; beliebige Modellparameter werden nicht garantiert unterstützt.
PNG-Aufgabe erstellen
GIF-Aufgabe erstellen
Abfragen und herunterladen
Der Generierungs-Endpunkt liefert HTTP202 mit task_id und poll_url. Fragen Sie bei pending oder processing weiter ab und beenden Sie die Abfrage bei completed oder failed. Senden Sie laufende Aufgaben nicht erneut.
completed laden Sie die Datei über result.data[0].url herunter. Ein erfolgreiches GIF-Ergebnis ist eine echte animierte Datei, keine Video-URL oder Sammlung einzelner Bilder. Liefert eine GIF-Anfrage ein Standbild oder ein falsches Format, schlägt die Aufgabe fehl; es gilt die normale Richtlinie zur Credit-Erstattung für fehlgeschlagene Aufgaben.
/v1/images/generations/sync akzeptiert dieselben Parameter. HTTP 200 liefert die Datei-URL in data[0].url; bei HTTP 202 wird die Aufgabe weiter abgefragt. /v1/images/edits akzeptiert ein Referenzbild per JSON oder Multipart-Upload, mit denselben PNG/GIF-Optionen und 30 Credits pro erfolgreicher Anfrage. Beispiele finden Sie im Leitfaden zur Bildgenerierung.
Beispiele für synchrones Warten und Bildbearbeitung
Nano Banana 2.1
Wählen Sie mitquality die Stufe 1K, 2K oder 4K (Standard: 1K). Die Aliase img_size, imageSize und resolution werden unterstützt, dürfen sich aber nicht widersprechen. size legt das Seitenverhältnis fest; image_urls übergibt Referenzbilder. 0.5K, Such- und Denkparameter sind nicht verfügbar.
/v1/tasks/{task_id} ab. Preis je Bild: 25 Credits für 1K, 50 für 2K und 75 für 4K.