OpenAI-kompatible Bildgenerierungs-API: GPT Image 2 Anleitung
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://www.bettertoken.ai/v1 als Base URL. Übermittle deinen BetterToken API Key über Authorization: Bearer YOUR_API_KEY.Schnellstart mit curl
Verwendehttps://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: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://www.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
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
固定使用 YOUR_MODEL_ID。
YOUR_MODEL_ID "YOUR_MODEL_ID"
图片生成提示词。
"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"
推荐固定为 1。多张图片建议发起多次独立请求。
1 <= x <= 11
图片尺寸和比例档位。auto 为自动;1024x1024 和 2048x2048 为 1:1;1536x1024 为 3:2;1024x1536 为 2:3;1536x1152 为 4:3;1152x1536 为 3:4;2048x1152 和 3840x2160 为 16:9;2160x3840 为 9:16。实际返回像素可能由服务端映射或调整,客户端应以解码后的真实图片尺寸为准。
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
推荐固定为 b64_json,便于稳定保存图片。
b64_json "b64_json"
推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。
png "png"

