GPT Image 2: Ihre erste Anfrage an die Image API

Was Sie benötigen

• curl, um die Anfrage zu senden;
• Ihren eigenen BetterToken API Key;
• die exakte Base URL https://www.bettertoken.ai/v1;
• das Modell gpt-image-2 für diese Image API;
• einen Base64-Decoder oder ein kurzes Python-Skript.

Schreiben Sie keinen echten Key in Quellcode, Screenshots oder einen Befehl, der in der Shell-Historie verbleibt. Speichern Sie ihn in einer Umgebungsvariable:

export BETTERTOKEN_API_KEY="your_api_key_here"

Der Wert oben ist nur ein Platzhalter. Verwenden Sie Ihren eigenen Key und veröffentlichen Sie ihn nie.

Ihre erste Anfrage an GPT Image 2

Senden Sie eine Anfrage an den Endpoint für die Bildgenerierung:

curl https://www.bettertoken.ai/v1/images/generations \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean editorial illustration of a coding desk at night, green and graphite palette"
  }' \
  -o image-response.json

Wenn die Anfrage erfolgreich ist, enthält image-response.json ein data-Objekt. Das Bild liegt in data[0].b64_json. Dieses Antwortformat eignet sich für serverseitige Abläufe: Sie können den Payload im Object Storage ablegen, an den nächsten Verarbeitungsschritt weitergeben oder direkt in eine lokale Datei dekodieren.

Das Bild speichern

Das folgende Beispiel liest das JSON, dekodiert den Base64-Wert und erzeugt bettertoken-image.png. Es verwendet nur die Python-Standardbibliothek:

import base64
import json

with open("image-response.json", "r", encoding="utf-8") as source:
    payload = json.load(source)

image_base64 = payload["data"][0]["b64_json"]

with open("bettertoken-image.png", "wb") as target:
    target.write(base64.b64decode(image_base64))

print("Saved: bettertoken-image.png")

Öffnen Sie die Datei und prüfen Sie, ob sie zum Prompt passt. Ein HTTP 200 bestätigt zwar die Anfrage, ersetzt aber keine visuelle Prüfung des Ergebnisses.

Die zweite Anfrage verbessern

Verwenden Sie für den ersten Test einen kurzen Prompt mit vier klaren Teilen:

1. Motiv oder Szene;
2. visueller Stil;
3. Komposition;
4. Farbpalette oder Beleuchtung.

Zum Beispiel:

Editorial illustration of a developer reviewing an API response,
clean geometric style, centered composition, dark graphite background
with restrained green accents, no text, no logos

Beginnen Sie nicht mit einer langen Liste widersprüchlicher Anforderungen. Prüfen Sie erst die grundlegende Komposition und ändern Sie dann jeweils nur einen Parameter. So lässt sich leichter erkennen, welche Formulierung das Ergebnis verändert hat.

Häufige Fehler

401: Key abgelehnt

Prüfen Sie, ob BETTERTOKEN_API_KEY im aktuellen Terminal gesetzt ist und der Authorization-Header das Präfix Bearer enthält. Geben Sie den Key nicht mit echo aus und senden Sie den vollständigen Wert nicht an den Support.

402 oder unzureichendes Guthaben

Öffnen Sie das BetterToken Dashboard und prüfen Sie das verfügbare Guthaben. Bezahltes BetterToken-Guthaben wird am Monatsende nicht automatisch zurückgesetzt, doch jede Anfrage benötigt weiterhin ausreichend Restguthaben.

404: falscher Pfad

Für die Bildgenerierung wird dieser vollständige Pfad verwendet:

https://www.bettertoken.ai/v1/images/generations

Ersetzen Sie ihn nicht durch den Chat-Completions-Endpoint und verwenden Sie nicht api.openai.com: Ein BetterToken-Key funktioniert mit dem BetterToken-Endpoint.

400: falsches Modell oder falsche Parameter

Beginnen Sie nur mit den Pflichtfeldern model und prompt. Dieser Leitfaden verwendet gpt-image-2. Wenn die API meldet, dass das Modell nicht verfügbar ist, vergleichen Sie aktuelle Model ID und Parameter mit der Image-API-Dokumentation.

429 oder 5xx

Starten Sie keine Endlosschleife für Wiederholungen. Notieren Sie HTTP-Status, Anfragezeit und einen sicheren Ausschnitt der Antwort und versuchen Sie es nach einer Wartezeit erneut. Im BetterToken Dashboard können Sie die Anfrage über die Zeit zuordnen und Modell, Status, Input-/Output-/Cache-Token sowie die Belastung prüfen, ohne den vollständigen Prompt anzuzeigen.

Prüfungen vor der Integration in eine Anwendung

Bevor Sie die Anfrage in ein Backend oder einen Automatisierungsablauf übernehmen, bestätigen Sie Folgendes:

• Der Key liegt in einer Umgebungsvariable oder einem Secrets Manager;
• die Anfrage geht an BetterToken und nicht an den Endpoint eines anderen Providers;
• Modell und Parameter stammen aus der aktuellen Dokumentation;
• der Base64-Payload lässt sich fehlerfrei dekodieren;
• die Anwendung begrenzt Wiederholungen und verarbeitet Nicht-2xx-Antworten;
• Kosten werden mit der aktuellen Preisseite und nicht mit einer alten Übersicht abgeglichen.

Danach können Sie denselben Vertrag in das SDK oder den HTTP-Client Ihrer Anwendung übertragen. Beginnen Sie mit der minimalen Anfrage, speichern Sie ein Ergebnis und fügen Sie erst dann Dimensionen, Qualitätseinstellungen, Stapelverarbeitung und Ihre eigene Speicherschicht hinzu.

Kurzfassung

Der erste funktionierende Ablauf hat drei Schritte: Senden Sie eine POST-Anfrage an die BetterToken Image API, lesen Sie data[0].b64_json und dekodieren Sie den Wert in eine Datei. Wenn Sie einen eigenen Key und nutzungsbasierte Abrechnung benötigen, erstellen Sie ein BetterToken-Konto und prüfen Sie aktuelle Parameter und Preise vor der Anfrage.