Skip to Content
ModelleGPT ImageText zu Bild

Text zu Bild

Ein Bild aus einem Text-Prompt generieren.

Sie schreiben keinen Code? Siehe Bilder in Ihren eigenen Tools generieren.

Vorbereitung

Sie benötigenDetails
API-SchlüsselErstellen Sie einen in der OfoxAI-Konsole  und ersetzen Sie YOUR_OFOX_API_KEY im Code
UmgebungcURL benötigt jq zum Dekodieren des Bildes; Python benötigt pip install openai; Node.js 18 oder neuer, keine Abhängigkeiten
TimeoutSetzen Sie das Client-Timeout auf 600 Sekunden. Hohe Qualität, große Formate oder Bearbeitungen können mehrere Minuten dauern
Im Code verwendete Werte
API-URLhttps://api.ofox.io/v1
Modell-IDopenai/gpt-image-2.5-flare
API-SchlüsselErsetzen Sie YOUR_OFOX_API_KEY im Code durch Ihren Schlüssel
Python-Abhängigkeitenpip install openai

Code

Jedes der folgenden Beispiele wurde unverändert ausgeführt. Das Ergebnis wird als output.png im aktuellen Verzeichnis gespeichert.

Terminal
curl -s https://api.ofox.io/v1/images/generations \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-image-2.5-flare", "prompt": "A red apple on a white table, soft natural light", "size": "1024x1024", "quality": "low" }' \ -o response.json # The image comes back as base64 — decode and save it (needs jq; on error, read response.json) jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Häufige Anpassungen

Ändern Sie einen Parameter in der obigen Anfrage:

ZielÄndernHinweise
Andere GrößesizeBenutzerdefinierte Größen müssen die vier Regeln erfüllen
Bessere QualitätqualityHöhere Stufen kosten mehr und dauern länger — siehe Qualität
Kleinere Dateienoutput_format, output_compressionAuf jpeg oder webp umstellen und dann die Kompression festlegen
Mehrere Bildern1–10, jedes Bild wird einzeln abgerechnet

Größe (size) und Qualität (quality)

  • Größe size: Breite und Höhe jeweils Vielfache von 16, längste Kante ≤ 3840, Seitenverhältnis zwischen 1:3 und 3:1, Gesamtpixel ≥ 655.360. 768x768 schlägt fehl; 1024x768 funktioniert. Wird sie weggelassen, entscheidet das Modell; in unseren Tests waren es 1254×1254. Siehe Größe.
  • Qualität quality: Bringen Sie die Anfrage zunächst mit low zum Laufen und erhöhen Sie dann. Weglassen ist nicht dasselbe wie medium; das Modell wählt selbst eine Stufe. gpt-image-2 hat kein xhigh oder max. Den Verbrauch pro Stufe finden Sie unter Qualität.

Parameterwerte

Zulässige Werte und gemessene Standardwerte für diese Reihe. Zu size und quality siehe Größe und Qualität auf der Überblicksseite.

Erforderlich
modelerforderlichstring· Werteopenai/gpt-image-2.5-flareopenai/gpt-image-2.5-sunburstopenai/gpt-image-2

Groß-/Kleinschreibung wird beachtet; eine falsche Schreibweise liefert 404. Geben Sie die vollständige ID mit dem Präfix openai/ an.

Häufig verwendet
ninteger· Standard 1· Werte1–10

Jedes Bild wird einzeln abgerechnet. Werte über 10 liefern 400.

output_formatstring· Standard png· Wertepngjpegwebp

Alle drei wurden erfolgreich gemessen.

▶Erweitert · 4output_compression · background · moderation · partial_imagesExpand
output_compressioninteger· Werte0–100

Gilt nur für jpeg und webp.

backgroundstring· Standard opaque· Werteopaquetransparentauto

Ein transparenter Hintergrund erfordert png oder webp; jpeg unterstützt keine Transparenz.

moderationstring· Werteautolow

Wie streng die Inhaltsmoderation ist.

partial_imagesinteger· Werte0–3

Wird zusammen mit stream: true verwendet: wie viele Zwischenbilder während der Generierung gesendet werden.

Häufige Fehler

FehlerUrsacheLösung
moderation_blockedDer Prompt wurde vom Sicherheitssystem des Upstream-Anbieters blockiertÄndern Sie den Prompt und versuchen Sie es erneut; eine unveränderte Wiederholung führt zum selben Ergebnis
Transparent background is not supported for JPEG output formatTransparenter Hintergrund mit jpeg angefordertVerwenden Sie png oder webp
404 model_not_foundModell-ID falsch geschrieben oder falsche Groß-/KleinschreibungKopieren Sie die Modell-ID von dieser Seite
Invalid sizeDie Größe verstößt gegen eine der vier oben genannten RegelnPassen Sie sie wie unter Größe und Qualität beschrieben an
does not support quality 'xhigh'xhigh oder max an gpt-image-2 gesendetVerwenden Sie high oder wechseln Sie zu 2.5
Invalid value: 'standard'quality auf standard oder hd gesetztVerwenden Sie low bis max
429 rate_limit_exceededMehr als 100 Anfragen pro Minute (pro Team)Später erneut versuchen

Weitere Fehler finden Sie in der vollständigen Fehlertabelle.

Offizielle Dokumentation

Die Dokumentation von OpenAI beschreibt das Verhalten bei direktem Aufruf von OpenAI. Beim Aufruf über OfoxAI haben die gemessenen Ergebnisse auf diesen Seiten Vorrang. So müssen Sie beispielsweise für die Bearbeitung keinen Anbieter festlegen.

Last updated on