Übersicht
Dieser Endpunkt bleibt für legacy OpenAI-kompatible Variations-Clients erhalten. Für aktuelle Image-to-Image-Workflows ist er nicht empfohlen; verwenden Sie nach Möglichkeit/v1/images/edits mit gpt-image-2 oder /v1/images/generations mit einem Image-to-Image-Modell wie nano-banana-pro. Erfordert multipart/form-data.
Anfragekörper
Timeout für synchrone Anfragen: Einige geroutete Bildanbieter geben das endgültige Bild inline zurück und warten dafür, bis die Generierung abgeschlossen ist. Hochauflösende oder hochwertige Anfragen können fast eine Minute oder länger dauern; setzen Sie das Timeout Ihres HTTP-Clients daher auf mindestens120s. Wenn die Create-Antwort status: "pending", task_id oder poll_url enthält, folgen Sie stattdessen der zurückgegebenen poll_url.
Das Bild als Basis für die Variation. Muss eine gültige PNG-Datei sein, kleiner als 50MB und quadratisch.
Erforderliche Modell-ID für legacy variationskompatible Routen. Es gibt keinen impliziten Standard; für aktuelle Image-to-Image-Workflows bevorzugen Sie
/v1/images/edits oder /v1/images/generations mit einem aktuellen Modell.Die Anzahl der zu generierenden Bilder. Muss zwischen 1 und 10 liegen.
Die Größe der erzeugten Bilder für legacy variationskompatible Routen. Unterstützte Werte hängen vom ausgewählten Modell ab.
Das Format der zurückgegebenen Bilder. Muss
url oder b64_json sein.Eine eindeutige Kennung für Ihren Endbenutzer zur Missbrauchsüberwachung.
Antwort
Unix-Zeitstempel der Bilderstellung.
Array der generierten Bildvariationen.Jedes Objekt enthält:
url(string): URL des Variationsbildes (wenn response_formaturlist)b64_json(string): Base64-kodiertes Bild (wenn response_formatb64_jsonist)
Hinweise
Dies ist ein legacy Kompatibilitätsendpunkt. Er ist nicht im aktuellen empfohlenen Bildmodellkatalog enthalten. Für neue Integrationen verwenden Sie
/v1/images/edits mit gpt-image-2 oder /v1/images/generations mit operation: "image-to-image" und einem aktuellen Image-to-Image-Modell.