Skip to main content
POST
cURL
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.
Verwende https://bettertoken.ai/v1 als Base URL. Übermittle deinen BetterToken API Key über Authorization: Bearer YOUR_API_KEY.
Du kannst Authorization und den Request-Body im Playground auf der rechten Seite eingeben und den Request dann direkt an https://bettertoken.ai/v1/images/generations senden.
Lege API Keys nicht in Browser-Frontend-Code, Git-Repositories, Tickets, Screenshots oder Logs ab. Speichere API Keys für serverseitige Proxy-Aufrufe nur in Server-Umgebungsvariablen oder einem Secret Manager.

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, um data[0].b64_json zu dekodieren.
  • Ein vorhandenes Bild bearbeiten: Verwende Image to image. Dabei werden eine oder mehrere Quelldateien als multipart/form-data gesendet.
  • 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

Verwende https://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:
Erstelle mehrere Bilder, indem du mehrere unabhängige Requests sendest. Verlasse dich nicht auf einen einzelnen Request mit 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:
Lies 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)

Verlasse dich nicht darauf, mit output_format: "jpeg" oder output_format: "webp" direkt JPEG- oder WebP-Dateien zu erhalten. Der aktuelle Endpunkt kann weiterhin PNG-Bildinhalt zurückgeben. Wenn dein Produkt JPEG oder WebP benötigt, empfange zuerst PNG und konvertiere es in deinem eigenen Code.

Antwortablauf

Dieser Endpunkt ist synchron. Halte nach dem Senden von POST /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, 429 und 5xx.
  • Wiederhole 400, 401, fehlende Parameter oder fehlerhafte Requests nicht automatisch.
  • Verwende exponentielles Backoff wie 3s, 8s und 15s.
  • 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 zuerst error.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/json und POST /images/generations.
  • model ist gpt-image-2, response_format ist b64_json, output_format ist png und n ist 1.
  • size ist einer der empfohlenen Werte, etwa 1024x1024.
  • Dein HTTP-Client erlaubt mehrere Minuten für die Generierung.

Verwandte Dokumentation

Autorisierungen

Authorization
string
header
erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
Standard:gpt-image-2
erforderlich

Use the GPT Image 2 model ID.

Verfügbare Optionen:
gpt-image-2
Beispiel:

"gpt-image-2"

prompt
string
erforderlich

A detailed description of the image to generate.

Beispiel:

"A futuristic AI product poster on a light background, with glass textures, a clean composition, and a premium technology aesthetic."

n
Standard:1

Use 1. Send separate requests when you need multiple output images.

Beispiel:

1

size
enum<string>
Standard:1024x1024

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.

Verfügbare Optionen:
auto,
1024x1024,
1536x1024,
1024x1536,
1536x1152,
1152x1536,
2048x2048,
2048x1152,
3840x2160,
2160x3840
Beispiel:

"1024x1024"

response_format
enum<string>
Standard:b64_json

Use b64_json.

Verfügbare Optionen:
b64_json
Beispiel:

"b64_json"

output_format
enum<string>
Standard:png

Use png. Do not rely on jpeg or webp being returned directly in the selected format.

Verfügbare Optionen:
png
Beispiel:

"png"

Antwort

Image generation result.