Ruf die gpt-image-2 API mit einem Bearer token auf und erhalte in rund 45 Sekunden ein gehostetes PNG zurück. Text-zu-Bild und Bild-zu-Bild teilen sich denselben Endpunkt. 2 Credits pro Bild, keine Vorauszahlung, keine SDK-Installation. Leg einen Key an und schick deinen ersten curl-Render ab, bevor dein Kaffee fertig ist.
Genutzt von 10.000+ Entwicklern, die mit der gpt-image-2 API ausliefern
Ein Endpunkt. Bearer Auth. Gehostete Ausgabe. Nichts weiter zu verdrahten.
Die gpt-image-2 API ist eine REST-Oberfläche, die einen prompt (und bis zu vier Referenzbilder) in ein produktionsreifes PNG verwandelt. Du schickst einen POST an /api/v1/images/generate mit einem Bearer token, erhältst eine task_id zurück und fragst /api/v1/images/task/[id] ab, bis das Bild fertig ist. Jede Antwort ist JSON — Success-Envelope bei 2xx, Error-Envelope mit stabilem Code und request_id bei 4xx und 5xx. Jeder Render wird in unserem R2 CDN gespeichert und über HTTPS ausgeliefert, sodass du die URL direkt verlinken oder in deinen eigenen Bucket spiegeln kannst. Credits werden bei Abgabe atomar abgezogen und bei einem fehlgeschlagenen Task automatisch erstattet, sodass deine Abrechnung nie von deiner tatsächlichen Ausgabe abweicht. Die Oberfläche ist nutzergebunden: Keys erben das Credit-Guthaben des zugehörigen Accounts und sehen nur programmatisch erzeugte Tasks, keine Tasks aus dem Web-Studio. Alles, was du sendest, ist JSON — keine Multipart-Uploads, kein SDK-Lock-in, keine versteckten Retries.
POST /api/v1/images/generate bedient sowohl Text-zu-Bild als auch Bild-zu-Bild für die gpt-image-2 API. Referenzbilder schalten den Modus automatisch um; der restliche Request-Body bleibt identisch.
Authentifiziere dich mit Authorization: Bearer YOUR_API_KEY. Die gpt-image-2 API weist Keys in Query-Strings ab, sodass deine token nie in CDN- oder Proxy-Logs landen.
Jeder abgeschlossene gpt-image-2 API Task liefert eine stabile https://file.gptimg.co URL. Kein Ablaufen signierter URLs, kein Download-und-Rehost-Loop, keine temporären Links.
Die gpt-image-2 API deckt quadratisch, Hochformat, Querformat, Widescreen und Ultra-Wide ab. Wähl das Seitenverhältnis, das deine Plattform braucht, und liefer aus. Kein Letterboxing nach der Generierung.
Wenn die gpt-image-2 API einen fehlgeschlagenen Task zurückgibt, wird die Credit-Belastung automatisch erstattet. Du musst nie ein Abgleichs-Skript schreiben.
Jede gpt-image-2 API Antwort, Erfolg oder Fehler, trägt einen X-Request-Id Header und eine passende request_id im Body. Support-Tickets werden in Minuten statt Tagen gelöst.
Ein prompt-Endpunkt, keine Infrastruktur aufzusetzen, eine Abrechnung, die du der Finanzabteilung erklären kannst
Liefer ein neues Bild-Feature aus, ohne GPU-Pods bereitzustellen oder einen Vendor-Vertrag zu verhandeln. Die gpt-image-2 API hat einen Pauschalpreis pro Render — 2 Credits für ein 1:1 Bild, linear mit der Batch-Größe. Pack einen Client hinter einem einzigen HTTP-Call in dein Backend, schalt das Feature hinter einem Flag frei und lass die Nutzung deinen Preispunkt finden. Teams kommen in weniger als einem Nachmittag von der Idee bis zum Staging.
Bild-zu-Bild mit bis zu vier Referenzen, alles über denselben Endpunkt
Übergib 1–4 https URLs in reference_images und die gpt-image-2 API schaltet automatisch in den Bild-zu-Bild-Modus. Teams greifen dafür zu Style Transfer, Restyle, Produkttausch und identitätswahrenden Edits. Kein separater Edit-Endpunkt, kein Multipart-Formular, kein Base64-Ballast — es werden nur http(s) URLs akzeptiert, sodass deine Request-Bodys klein und deine Logs lesbar bleiben.
Stabile Error-Codes, request_id-Korrelation, provider-verborgene Meldungen
Jede gpt-image-2 API Antwort trägt eine request_id, die du in Support-Tickets zitieren kannst. Fehler folgen einem einheitlichen Envelope mit error.code, error.message und error.request_id Feldern. Ein kleiner Satz stabiler Codes deckt jeden Fehlerfall ab — UNAUTHORIZED, INVALID_REQUEST, INSUFFICIENT_CREDITS, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR. Upstream-Provider-Namen werden aus jeder Meldung entfernt, sodass deine Clients nie durchgesickerte Vendor-Interna sehen, wenn etwas schiefgeht.
Pauschale Credits, R2-Mirroring und eine einzige Oberfläche für beide Modi
Die gpt-image-2 API gibt dir einen pauschalen Credit-Preis pro Render, gehostete PNG URLs, die nicht nach 24 Stunden ablaufen, und einen einzigen Endpunkt, der Text-zu-Bild und Bild-zu-Bild abdeckt. Dasselbe Bild über OpenAIs images-Endpunkt kostet $0.01–$0.20 je nach Größe und Qualität, mit temporären signierten URLs, die du herunterladen und neu hosten musst. Batch n=4 und zahl lineare Credits — keine separaten Endpunkte, keine versteckte Qualitätsstufen-Preisgestaltung, keine Per-Seat-Lizenzierung.
Vier Schritte. Der erste curl in unter fünf Minuten.
Melde dich an, öffne Einstellungen → API Keys, klick auf Erstellen und kopiere den Klartext-Key einmal. Die gpt-image-2 API zeigt den Key nur beim Erstellen an — leg ihn in einem Secret Manager ab.
Schick JSON mit prompt, aspect_ratio, n und optional reference_images. Die gpt-image-2 API liefert sofort eine task_id und einen processing-Status zurück.
Warte nach der Abgabe zehn Sekunden und poll dann alle fünf Sekunden, bis die gpt-image-2 API den Status auf completed oder failed umschaltet. Die typische Ende-zu-Ende-Latenz liegt bei 45–60 Sekunden.
Abgeschlossene gpt-image-2 API Antworten enthalten eine stabile https://file.gptimg.co URL. Verlink sie direkt, spiegel sie in deinen Storage oder reich sie direkt an dein Frontend weiter.
Integration, Preise und Rate Limits
Die gpt-image-2 API kommt mit kostenlosen Signup-Credits, einem Bearer token in zwei Klicks und einem 45-Sekunden-Round-Trip vom prompt zum gehosteten PNG. Keine SDK-Installation, keine Kreditkarte für den Start.