Skip to main content
POST
Hinweis zur Modellnamen-Kompatibilität: Diese Schnittstelle unterstützt auch den Alias gpt-image-2-ext, der gpt-image-2 entspricht. Beide sind austauschbar und liefern identische Ergebnisse.

Autorisierung

string
erforderlich
Alle Endpunkte erfordern eine Authentifizierung per Bearer TokenAPI-Schlüssel erhalten:Besuchen Sie die Seite zur Verwaltung von API-Schlüsseln, um Ihren API-Schlüssel zu erhaltenFügen Sie ihn in den Anfrage-Header ein:

Body

string
Standard:"gpt-image-2"
erforderlich
Name des BildgenerierungsmodellsFest auf gpt-image-2 gesetzt (kompatibler Alias gpt-image-2-ext)
Zur Kompatibilität mit älteren Aufrufen kann der Alias gpt-image-2-ext (entspricht gpt-image-2) weiterhin verwendet werden.
boolean
Standard:"false"
Legt fest, ob der Inhalt vor dem Absenden des Bildauftrags moderiert wird.
  • true: Prompts und Eingabebilder mit omni-moderation-latest prüfen
  • false oder nicht angegeben: keine Moderationsanfrage und damit keine zusätzlichen Moderationskosten oder Verzögerung (Standard)
string
erforderlich
Textbeschreibung für die Bildgenerierung
  • Unterstützt Englisch und Chinesisch, detaillierte Beschreibungen werden empfohlen
  • Inhaltsmoderation / Sicherheitsprüfung vor dem Einreichen — Verstöße werden sofort abgelehnt
integer
Standard:"1"
Anzahl der zu generierenden BilderWert: 1
Muss eine reine Zahl sein (z. B. 1), nicht in Anführungszeichen setzen
string
Standard:"1:1"
Seitenverhältnis des BildesUnterstützte Seitenverhältnisse, plus auto, damit der Server automatisch ein passendes Verhältnis auswählt:Pixelabmessungen können auch direkt übergeben werden, z. B. 1881x836 / 887x1774.
Wenn size auf auto gesetzt ist, beträgt das Standardverhältnis 1:1.
string
Standard:"1k"
AusgabeauflösungsstufeOptionen: 1k / 2k / 4ksize × resolution → tatsächliche Pixelzuordnung:
4K unterstützt die oben aufgeführten 15 Seitenverhältnisse; Sie können die Pixelabmessungen aus der Tabelle auch direkt über size übergeben.
array
Array von Referenzbildern (OpenAI-Standardfeld). Wechselt bei Angabe in den Bild-zu-Bild-Modus.
Andere OpenAI-Standardfelder (response_format, style) werden nicht unterstützt und ignoriert. Aufgabenergebnisse geben nur url zurück — bitte laden Sie das Bild bei Bedarf selbst herunter und konvertieren Sie es in Base64.
boolean
Standard:"false"
Ob auf den offiziellen Kanal zurückgegriffen werden soll
  • false: Nicht verwenden (Standard)
  • true: Offiziellen Kanal verwenden

Anwendungsbeispiele

Text-zu-Bild (minimale Anfrage)
Text-zu-Bild (mit Seitenverhältnis + 2K)
Text-zu-Bild (4K-Ausgabe)
Text-zu-Bild (mehrere Bilder)
Bild-zu-Bild (Referenz = URL)
Bild-zu-Bild (Referenz = Base64)
Bild-zu-Bild (Mehrfachreferenz-Fusion, URL + Base64 gemischt)

Response

integer
Statuscode der Antwort
array
Array mit Antwortdaten

Abfrage der Aufgabenergebnisse

Nach erfolgreicher Einreichung wird eine task_id zurückgegeben. Pollen Sie den Aufgabenstatus über GET /v1/tasks/{task_id}, siehe API zur Aufgabenabfrage für Details.

Beispiel einer erfolgreichen Antwort

Bildzugriff: data.result.images[0].url[0]

Aufgabenstatus