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://www.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://www.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.

Schnellstart mit curl

Verwende https://www.bettertoken.ai/v1 als Base URL und sende einen Request an https://www.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://www.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

Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.

Body

application/json
model
enum<string>
Standard:YOUR_MODEL_ID
erforderlich

固定使用 YOUR_MODEL_ID。

Verfügbare Optionen:
YOUR_MODEL_ID
Beispiel:

"YOUR_MODEL_ID"

prompt
string
erforderlich

图片生成提示词。

Beispiel:

"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"

n
integer
Standard:1

推荐固定为 1。多张图片建议发起多次独立请求。

Erforderlicher Bereich: 1 <= x <= 1
Beispiel:

1

size
enum<string>
Standard:1024x1024

图片尺寸和比例档位。auto 为自动;1024x1024 和 2048x2048 为 1:1;1536x1024 为 3:2;1024x1536 为 2:3;1536x1152 为 4:3;1152x1536 为 3:4;2048x1152 和 3840x2160 为 16:9;2160x3840 为 9:16。实际返回像素可能由服务端映射或调整,客户端应以解码后的真实图片尺寸为准。

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

"1024x1024"

response_format
enum<string>
Standard:b64_json

推荐固定为 b64_json,便于稳定保存图片。

Verfügbare Optionen:
b64_json
Beispiel:

"b64_json"

output_format
enum<string>
Standard:png

推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。

Verfügbare Optionen:
png
Beispiel:

"png"

Antwort

Image generation result.

OpenAI-compatible image response. Clients should read data[0].b64_json and allow additional fields such as revised_prompt.

created
integer
Beispiel:

1710000000

data
object[]