GPT Image 2 API-Key: Zugang holen und erste Anfrage senden

Ja, GPT Image 2 hat eine API, und bei SeedRouter bekommst du mit einem einzigen API-Key Zugang dazu. Melde dich an, erstelle einen Key auf der Seite API-Keys, lade auf der Seite Abrechnung Guthaben auf und sende den Key im Header Authorization: Bearer an https://api.seedrouter.ai/v1/images/generations. Der Key wird nur ein einziges Mal vollständig angezeigt, nämlich beim Erstellen. Kopiere ihn also direkt in die Umgebung deines Servers.

Die folgenden Schritte führen dich vom fehlenden Konto bis zum fertigen Bild und behandeln die vier Fehler, an denen die meisten ersten Anfragen scheitern.

Wie bekommst du einen GPT Image 2 API-Key?

Melde dich mit deinem Google-Konto bei SeedRouter an.
Öffne API-Keys und erstelle einen Key. Gib ihm einen Namen, der sagt, wo er laufen wird, etwa production-server.
Kopiere den Key sofort. Nach diesem Bildschirm siehst du nur noch eine maskierte Version, und ein verlorener Key lässt sich nicht wiederherstellen. Widerrufe ihn stattdessen und erstelle einen neuen.
Lade auf der Seite Abrechnung Guthaben auf. Ein Key funktioniert, sobald er existiert, aber eine Anfrage braucht Guthaben, um zu laufen.

Ein Key erreicht jedes Modell auf SeedRouter. Du brauchst also keinen eigenen Key für GPT Image 2 und GPT Image 2.5. Erstelle stattdessen getrennte Keys pro Umgebung. Dann kann das Widerrufen des Staging-Keys die Produktion nicht lahmlegen.

Wo sollte der API-Key gespeichert sein?

Auf deinem Server, in einer Umgebungsvariable, und nirgendwo sonst:

export SEEDROUTER_API_KEY="your-key"

Leg den Key niemals in Browser-JavaScript, ein Bundle einer Mobile-App oder ein öffentliches Repository. Wer ihn lesen kann, kann dein Guthaben ausgeben. Hat dein Produkt ein Frontend, lass es dein eigenes Backend aufrufen, und lass das Backend die API mit dem Key aufrufen.

Wird ein Key doch einmal öffentlich, widerrufe ihn sofort auf der Seite API-Keys. Ein widerrufener Key funktioniert nicht mehr, und Anfragen, die ihn verwenden, werden abgelehnt.

Wie sendest du mit dem Key eine erste Anfrage?

Sende den Key als Bearer-Token. Die Antwort ist ein Verweis auf eine Aufgabe, nicht das Bild:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Speichere die id aus der Antwort und frage GET https://api.seedrouter.ai/v1/tasks/{id} mit demselben Header ab, bis status den Wert completed hat. Die fertige Aufgabe listet die Bild-URLs auf. Eine vollständige Schleife im Code findest du in der GPT Image 2 API in Python.

Zwei Modell-IDs bedienen GPT Image 2 mit denselben Feldern: gpt-image-2 berechnet einen festen Preis pro geliefertem Bild, gpt-image-2-official rechnet die Token ab, die jedes Rendering meldet. Der Key funktioniert mit beiden. Die aktuellen Preise stehen auf der Modellseite.

Welche Fehler treffen einen neuen API-Key am häufigsten?

Fehlercode	HTTP	Was er bedeutet	Was zu tun ist
`10001`	401	Der Key fehlt, ist falsch geschrieben oder widerrufen	Sende den vollständigen Key im Header `Authorization`
`20002`	400	Der Wert von `model` ist keine angebotene ID	Verwende exakt `gpt-image-2` oder `gpt-image-2-official`
`20001`	400	Ein Feld ist falsch; die Meldung nennt es, wenn möglich	Korrigiere dieses Feld, bevor du es erneut versuchst
`30001`	402	Das Konto hat kein Guthaben mehr	Guthaben aufladen und erneut senden

Zwei Versehen verursachen die meisten Fehlschläge bei ersten Anfragen. Das eine ist ein eingefügter Key mit einem fehlenden Zeichen oder einem überzähligen Leerzeichen, was 10001 zurückgibt. Das andere ist ein aus einer Überschrift kopierter Modellname wie gpt-image-2.0 oder GPT Image 2 statt der Modell-ID, was 20002 zurückgibt. Beides wird abgelehnt, bevor irgendeine Arbeit beginnt, es wird also nichts berechnet.

Gibt es einen kostenlosen GPT Image 2 API-Key?

Nein. Einen Key zu erstellen ist kostenlos, aber Anfragen werden aus Prepaid-Guthaben bezahlt. Was du nicht bezahlst, ist ein Fehlschlag: Eine Aufgabe, die mit failed endet oder kein Bild zurückgibt, kostet nichts. Guthaben kaufst du als einmalige Aufladung, es verfällt nie und ist an kein Abo gebunden. Eine kleine erste Aufladung reicht also, um eine Integration gründlich zu testen.

Lässt sich ein Key aus Python und JavaScript nutzen?

Ja. Der Key ist eine Zeichenkette in einem HTTP-Header, also kann ihn jede Sprache nutzen, die eine HTTP-Anfrage senden kann. Lies ihn in jeder Laufzeitumgebung aus der Umgebung: os.environ["SEEDROUTER_API_KEY"] in Python und process.env.SEEDROUTER_API_KEY in Node.js. Halte das JavaScript auf der Serverseite; derselbe Key im Browsercode ist für jeden Besucher sichtbar.

Häufig gestellte Fragen

Brauche ich einen OpenAI-API-Key, um GPT Image 2 hier zu nutzen?

Nein. Dein SeedRouter-Key ist die einzige Zugangsberechtigung, die du sendest. Du erstellst oder verwaltest kein separates Konto an anderer Stelle, um GPT Image 2 über diese API aufzurufen.

Wie viele API-Keys kann ich erstellen?

Genug für einen pro Server oder Dienst; das Limit pro Konto liegt weit über dem, was eine Integration braucht. Jeder Key lässt sich einzeln widerrufen.

Wo sehe ich, was ein Key ausgegeben hat?

Im Nutzungsverlauf. Jede Anfrage führt ihr Modell und ihren Betrag auf. So lässt sich eine neue Integration leicht mit deiner Schätzung abgleichen.

Den Key auf dem Server behalten und loslegen

Erstelle einen Key pro Umgebung, speichere ihn in einer Umgebungsvariable und sende ihn nur von deinem Backend aus als Bearer-Token. Sobald die erste Anfrage eine Aufgaben-id zurückgibt, ist der Zugangsteil erledigt; alles Weitere steht in der GPT Image 2 API-Referenz.

GPT Image 2 API-Key: Zugang erhalten und die erste Anfrage senden