Skip to main content
POST

Unterstützte Modelle

Autorisierung

string
erforderlich
Alle API-Anfragen 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 Folgendes in Ihren Anfrage-Headern hinzu:

Body

string
erforderlich
Modellname
  • gpt-image-1-official – Stabilität im Vordergrund, geeignet für allgemeine Bildgenerierung
  • gpt-image-1.5-official – Neue Version, geeignet für höhere Qualität und komplexe Bearbeitung
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 sowohl Chinesisch als auch Englisch
string
Standard:"1:1"
SeitenverhältnisUnterstützte Verhältnisse:
  • 1:1 – Quadrat (Standard)
  • 3:2 – Querformat
  • 2:3 – Hochformat
integer
Standard:"1"
Anzahl der zu generierenden BilderBereich: 1–4
  • Werte ≤ 0 werden als 1 behandelt
  • Werte > 4 werden als 4 behandelt
Warnung: Muss eine reine Zahl sein (z. B. 1), keine Anführungszeichen verwenden, sonst tritt ein Fehler auf
string
Standard:"auto"
Bildqualität
  • auto – Automatische Qualitätsauswahl (Standard)
  • low – Schneller, sparsamer
  • medium – Ausgewogenes Verhältnis zwischen Qualität und Kosten
  • high – Höhere Qualität, höhere Kosten
string
Standard:"auto"
Hintergrundmodus
  • auto – Automatischer Hintergrund (Standard)
  • opaque – Undurchsichtiger Hintergrund
  • transparent – Transparenter Hintergrund, empfohlen mit Ausgabeformat png
background: transparent kann nicht gleichzeitig mit output_format: jpeg verwendet werden
string
Standard:"auto"
Moderationsstufe
  • auto – Standard-Moderationsstufe
  • low – Mildere Moderation
string
Standard:"png"
Ausgabeformat
  • png – Standardformat, geeignet für transparente Hintergründe
  • jpeg – Kleinere Dateigröße, geeignet für allgemeine Bildausgabe
background: transparent kann nicht gleichzeitig mit output_format: jpeg verwendet werden
integer
Ausgabe-Kompressionsstufe, Bereich 0–100
  • Nur für jpeg empfohlen
  • Für png nicht empfohlen
array
Array von URLs für Referenzbilder, aktiviert bei Angabe den Bild-zu-Bild-ModusLimit: Bis zu 15 Referenzbilder
string
Masken-Bild-URL für Inpainting
  • Muss zusammen mit image_urls verwendet werden
  • Wird über die offizielle Bearbeitungs-API übermittelt
  1. Stellen Sie vor dem Hochladen der Maske sicher, dass der Alphakanal des Bildes auf „Ja” gesetzt ist.
  2. Die Größe der Maske muss mit dem ersten Referenzbild übereinstimmen.

Größenreferenz

Seitenverhältnisse werden nach außen verwendet; das System ordnet sie intern automatisch den offiziellen Abmessungen zu.

Anwendungsbeispiele

Text-zu-Bild (minimal)
Text-zu-Bild (vollständige Parameter)
Bild-zu-Bild (einzelne Referenz)
Bild-zu-Bild (Mehrfachreferenz-Fusion)
Mehrere Bilder (n > 1)

Response

integer
Statuscode der Antwort
array
Array mit Antwortdaten

Hinweise

  1. Asynchrone Verarbeitung: Nach dem Einreichen wird eine task_id zurückgegeben. Pollen Sie /v1/tasks/{task_id}, um die Ergebnisse abzurufen
  2. Modellauswahl: Verwenden Sie gpt-image-1-official für die allgemeine Bildgenerierung; verwenden Sie gpt-image-1.5-official für hochwertige Bearbeitung und komplexe Bild-zu-Bild-Aufgaben
  3. Anforderungen an Bild-URLs: Verwenden Sie für Bild-zu-Bild öffentlich zugängliche und stabile Bild-URLs
  4. Abrechnung: Abrechnung pro erfolgreich generiertem Bild; keine Abrechnung bei Fehlern