API zur Bildgenerierung
Erstelle Bilder aus Text mit GPT Image 2 und BetterTokens OpenAI-kompatibler API: API Key, Base URL, Parameter, Python, JavaScript und Fehlerbehebung.
POST /v1/images/generations
Der Text-zu-Bild-Endpunkt verwendet einen Request-Body im Format application/json. Sende einen Prompt, halte den HTTP-Request geöffnet und lies das generierte Bild aus data[0].b64_json in derselben Antwort.
https://bettertoken.ai/v1 als Base URL. Übermittle deinen BetterToken API Key über Authorization: Bearer YOUR_API_KEY.Passenden Ablauf wählen
- Ein Bild aus Text generieren und das Ergebnis speichern: Bleibe auf dieser Seite. Beginne mit dem
curl-Beispiel und verwende anschließend Bild speichern, umdata[0].b64_jsonzu dekodieren. - Ein vorhandenes Bild bearbeiten: Verwende Image to image. Dabei werden eine oder mehrere Quelldateien als
multipart/form-datagesendet. - Modell und Parameter wählen und das Budget schätzen: Prüfe aktuelle Model IDs und Preise in der model plaza und verwende unten Empfohlene Werte für die Request-Parameter. Der englische Artikel zum ersten GPT-Image-2-Request erläutert den vollständigen Request-Response-Ablauf.
Schnellstart mit curl
Verwendehttps://bettertoken.ai/v1 als Base URL und sende einen Request an https://bettertoken.ai/v1/images/generations:
Empfohlene Werte
Sende diese Felder in jedem Request explizit:n > 1.
Empfohlene Größen
size steht für das erwartete Seitenverhältnis und die Größenstufe. Die tatsächlich zurückgegebenen Pixel können vom Server zugeordnet oder angepasst werden. Verwende die dekodierten Bildabmessungen, statt die Ausgabe zwangsweise auf den angeforderten Wert zuzuschneiden.
Bild speichern
Eine erfolgreiche Antwort folgt dem OpenAI-kompatiblen Bildantwortformat:data[0].b64_json und speichere es als Base64-Bildinhalt. Die Antwort kann zusätzliche Felder wie revised_prompt enthalten; erlaube diese Felder in deinem Client.
Setze immer output_format: "png". Speichere das dekodierte Bild dann als .png, ohne Dateikopfzeilen zu prüfen.
JavaScript example (Node.js)
Antwortablauf
Dieser Endpunkt ist synchron. Halte nach dem Senden vonPOST /images/generations den aktuellen HTTP-Request offen, bis der Server antwortet. Bei erfolgreicher Generierung wird der Bildinhalt in data[0].b64_json zurückgegeben.
Der Endpunkt gibt keine task_id zurück; es gibt keinen separaten Endpunkt für Statusabfragen oder das Herunterladen von Ergebnissen.
Timeouts und Wiederholungen
- Setze HTTP-Client-Timeouts auf mehrere Minuten.
- Wiederhole Transportfehler,
408,409,425,429und5xx. - Wiederhole
400,401, fehlende Parameter oder fehlerhafte Requests nicht automatisch. - Verwende exponentielles Backoff wie
3s,8sund15s. - Wenn doppelte Bilder nicht akzeptabel sind, zeichne vor der Wiederholung eine eigene Request-ID auf.
Fehlerbehandlung
Fehler geben gewöhnlich JSON zurück. Lies beim Anzeigen eines Fehlers zuersterror.message, dann message und anschließend den HTTP-Status-Text.
Integrations-Checkliste
- Die Base URL lautet
https://bettertoken.ai/v1. - Der Header enthält
Authorization: Bearer YOUR_API_KEY. - Der Request verwendet
application/jsonundPOST /images/generations. modelistgpt-image-2,response_formatistb64_json,output_formatistpngundnist1.sizeist einer der empfohlenen Werte, etwa1024x1024.- Dein HTTP-Client erlaubt mehrere Minuten für die Generierung.
Verwandte Dokumentation
Autorisierungen
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Use the GPT Image 2 model ID.
gpt-image-2 "gpt-image-2"
A detailed description of the image to generate.
"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."
Use 1. Send separate requests when you need multiple output images.
1
The requested image size or aspect-ratio tier. The server may map or adjust the final pixel dimensions, so inspect the decoded image for its actual size.
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
Use b64_json.
b64_json "b64_json"
Use png. Do not rely on jpeg or webp being returned directly in the selected format.
png "png"
Antwort
Image generation result.

