OpenAI Images API Konfiguration
Bildgenerierung nutzt nicht die reguläre Chat-Schnittstelle. Selbst wenn ein AI-Provider das Textmodell unterstützt, bedeutet dies nicht zwangsläufig, dass er auch die OpenAI-Bildschnittstelle unterstützt. Prüfen Sie beim Provider vor der Konfiguration, ob er explizit die 'Images API', 'Bildgenerierung' oder das entsprechende Modell erwähnt.
Offizielle Informationen Downloads und Dokumentation unterliegen der offiziellen Website.
Zuerst prüfen, ob der Provider die Bildschnittstelle unterstützt
| Was zu prüfen ist | Wie zu prüfen | Warum |
|---|---|---|
| Schnittstellentyp | Ob im Backend oder in der Dokumentation explizit Images API, Bildgenerierung, Bildbearbeitung erwähnt werden | Die Angabe einer OpenAI-kompatiblen Chat-Schnittstelle bedeutet nicht, dass auch die Bildschnittstelle verfügbar ist |
| Modellberechtigungen | Ob die Modellliste Bildmodelle enthält und ob das Konto oder der Key die Berechtigung hat | Bildmodelle werden oft separat abgerechnet und unabhängig von Textmodellen freigeschaltet |
| Anfragepfad | Ob der Provider Beispiele für die Bildschnittstelle bereitgestellt hat | Einige Provider leiten nur die Chat-Schnittstelle weiter; eine direkte Anfrage an den Bildpfad führt zu 404 |
| Preis | Bilder werden pro Stück, Größe oder Qualität abgerechnet | Testen Sie vor der Batch-Generierung mit einer kleinen Menge, um unerwartet hohe Kosten zu vermeiden |
Unterschiede zur Chat-Schnittstelle
| Typ | Gängige Schnittstellen | Erforderliche Vorbereitung |
|---|---|---|
| Text-Chat | /v1/chat/completions oder Responses | Key, Base URL, Modellname, Nachrichteninhalt |
| Bildgenerierung | /v1/images/generations | Key, Bildmodell, Prompt, Größe, Ausgabeformat |
| Bildbearbeitung | Bildbearbeitungsschnittstelle | Zusätzlich zum Prompt müssen Sie auch das Originalbild oder eine Maske hochladen |
So füllen Sie die Felder aus
| Konfigurationselement | Ausfüllmethode |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Model | Offizielles Beispiel verfügbar: <code>gpt-image-2</code>; bei Provider-Diensten gemäß der Provider-Liste eintragen |
| Prompt | Welches Bild möchten Sie generieren |
| Size | Bildgröße |
| Format | URL oder base64 |
Wenn Sie einen Provider nutzen, ersetzen Sie den offiziellen Domainteil durch die vom Provider bereitgestellte Bild-API-Adresse; falls der Provider keine Unterstützung für die Bildschnittstelle angegeben hat, gehen Sie nicht davon aus, dass sie verfügbar ist. Ob die Base URL /v1 enthält, entnehmen Sie weiterhin dem Backend-Beispiel – raten Sie nicht selbst.
Anfragebeispiel
OpenAI-Bildgenerierungsbeispiel
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'Die Kosten der Bildschnittstelle weichen in der Regel von der Textschnittstelle ab. Prüfen Sie die Preise vor der Batch-Generierung.
| Fehler | Häufige Ursachen | Lösungen |
|---|---|---|
| 404 / endpoint not found | Der Provider verfügt über keine Bild-Proxy-Schnittstelle, oder der Pfad enthält zu viele/zu wenige Schrägstriche /v1 | Suchen Sie im Backend nach einem dedizierten Beispiel für die Bildschnittstelle; verwenden Sie nicht direkt die Chat-Schnittstelle |
| model not found | Der Name des Bildmodells ist nicht in der aktuellen Liste des Providers enthalten | Kopieren Sie die ursprüngliche Modell-ID bzw. den Modellnamen des Bildmodells, nicht den des Textmodells |
| unsupported content type | Die Bildbearbeitungsschnittstelle erfordert das Hochladen von Dateien; reines JSON reicht nicht aus | Prüfen Sie zunächst, ob Sie die Generierungsschnittstelle oder die Bearbeitungsschnittstelle aufrufen |