Kurzantwort
- Der Einstiegspunkt ist POST /v1/images/generations; setzen Sie model=gpt-image-2 im Request-Body.
- Unterstützt Prompt-Generierung sowie Referenzbilder per URL in reference_images für referenzgeführte Generierung oder Bearbeitung.
- Referenzbilder sind ausschließlich als URL möglich; lokale Dateien müssen zuerst hochgeladen werden, statt base64 direkt zu übergeben.
- Der Endpoint arbeitet mit asynchronen Aufgaben: Er liefert eine Aufgaben-ID, das Ergebnis wird anschließend über den Status-Endpoint der Bildaufgabe abgefragt.
- Die offiziellen Listenpreise liegen bei etwa $0.22 / $0.50 / $1.30 pro Bild für 1K / 2K / 4K; ToAPIs zeigt derzeit $0.015 / $0.020 / $0.025 pro Bild auf der Vergleichsseite, die endgültige Abrechnung richtet sich nach Ihrem Kontopreis.
- Bei der ToAPIs-1K-Rate von $0.015 pro Bild entsprechen $10 Aufladung etwa 600 zusätzlichen 1K-Bildern; bei der 4K-Rate von $0.025 pro Bild etwa 400 4K-Bildern.
Wichtige Parameter
- model | string | erforderlich | gpt-image-2 | - | Verwenden Sie gpt-image-2 als exakte Modellkennung.
- prompt | string | erforderlich | - | - | Haupt-Prompt für die Bildgenerierung oder -bearbeitung.
- size | string | optional | 1:1 | 1K: 1:1 | 3:2 | 2:3; 2K: 1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 5:4 | 4:5 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21; 4K: 4:3 | 3:4 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9 | 9:21 | Ausgabe-Seitenverhältnis; die zulässigen Werte hängen von der gewählten Auflösungsstufe ab.
- resolution | string | optional | 1K | 1K | 2K | 4K | Auflösungsstufe der Ausgabe; muss einer unterstützten size-Kombination entsprechen.
- reference_images | string[] | optional | - | URL-Array | URL-Array mit Referenzbildern für referenzgeführte Generierung oder Bearbeitung. Lokale Bilder müssen zuerst hochgeladen werden; base64 direkt wird nicht unterstützt.
- image_urls | string[] | optional | - | URL-Array (Kompatibilitätsfeld) | Kompatibilitätsfeld; bestehende Aufrufe funktionieren weiter, für neue Integrationen ist reference_images zu bevorzugen.










