Für den Zugang zur OpenAI API braucht man vier Dinge: ein Konto, mit dem man sich anmelden kann, einen verwendbaren API Key, ein Projekt mit aktivierter Abrechnung sowie die richtige Base URL und einen erfolgreichen Aufruf. Das klingt einfach. In der Praxis scheitern neue Teams aber selten am Code, sondern an der Kontostruktur, der Zahlungsmethode und der korrekten Zusammensetzung der Adresse.

Dieser Leitfaden folgt der tatsächlichen Reihenfolge: Konto und Projekt, Key erstellen, Guthaben aufladen, SDK installieren, erster Aufruf mit der Responses API, Nutzung prüfen, 401 und 429 analysieren und zum Schluss die Base URL auf ein OpenAI-kompatibles Gateway umstellen. Die Beispiele verwenden überwiegend die Responses API; ältere Werkzeuge, die nur Chat Completions unterstützen, lassen sich nach demselben Muster anpassen.

Hinweis: OpenAI, ChatGPT und GPT sind Marken von OpenAI. Dieser Artikel beschreibt das öffentlich dokumentierte Schnittstellenverhalten im Oktober 2026. Modellnamen, Kontingente und Preise entnehmen Sie bitte der Preisübersicht und der offiziellen Dokumentation.

1. Konto, Organisation und Projekt

Die OpenAI-Plattform kennt mindestens drei Ebenen, die man leicht verwechselt:

  • Konto: die Anmeldeidentität und damit die Frage, wer Zugriff auf die Konsole hat;
  • Organisation: die Einheit, der Abrechnung und Nutzung zugeordnet werden; Teams verwalten ihre Zusammenarbeit meist auf dieser Ebene;
  • Projekt: die Isolationseinheit für Keys, Verbrauch und Berechtigungen; empfehlenswert ist eine Aufteilung nach Umgebung oder Geschäftsbereich.

Ein häufiges Missverständnis ist, das ChatGPT-Abonnement mit dem API-Guthaben gleichzusetzen. Beide sind getrennt: Das Abonnement regelt die Nutzung des Chat-Produkts, die API wird nach tatsächlichen Aufrufen separat abgerechnet. Klären Sie vor dem Einstieg, wer das Konto verantwortet, wer bezahlt und wer Administratorrechte besitzt. Sonst ist bei einem Personalwechsel später unklar, wem welche Keys gehören.

2. Einen API Key erstellen

Gehen Sie in dieser Reihenfolge vor und überspringen Sie keine Schritte:

  1. Melden Sie sich mit einem Administratorkonto in der API-Konsole an und prüfen Sie, ob die richtige Organisation aktiv ist.
  2. Legen Sie unter der Organisation ein neues Projekt an oder wählen Sie eines aus; trennen Sie Entwicklung, Test und Produktion.
  3. Öffnen Sie im Projekt die Seite für API Keys und erstellen Sie einen neuen Schlüssel.
  4. Geben Sie dem Key einen sprechenden Namen, zum Beispiel „Produktion-Kundenservice-Bot“.
  5. Kopieren Sie den vollständigen Key sofort und legen Sie ihn in einem Passwortmanager oder im Secret Store der Deployment-Plattform ab.
  6. Legen Sie bei Bedarf Projektberechtigungen, Budgets oder Obergrenzen fest und speichern Sie.

Der vollständige Key wird in der Regel nur einmal bei der Erstellung angezeigt. Dass später nur die ersten und letzten Zeichen sichtbar sind, ist normal; verlassen Sie sich nicht darauf, ihn erneut kopieren zu können. Wenn der Key verloren geht, erstellen Sie einen neuen und deaktivieren den alten, statt nach einer Wiederherstellung zu suchen.

3. Aufladen, Abrechnung und Kontingente

Ob die API vorausbezahlt oder nachträglich abgerechnet wird, hängt vom Kontotyp und der Region ab; maßgeblich ist die Anzeige in der Konsole. Prüfen Sie vor der Aktivierung drei Punkte:

  1. ob die Zahlungsmethode Ihre Karte oder Ihren Kanal unterstützt;
  2. wie Abrechnungszyklus und Rechnungen funktionieren;
  3. ob sich Budgetwarnungen und harte Obergrenzen pro Projekt einrichten lassen.

Fehlgeschlagene Zahlungen sind beim Einstieg ein häufiges Problem. Wird eine Karte abgelehnt, prüfen Sie zuerst Rechnungsadresse, Name des Karteninhabers und Verifizierungsverfahren und wenden Sie sich dann an die ausgebende Bank. Vermeiden Sie schnelle Wiederholungsversuche, da einige Risikoprüfungen die Karte sonst sperren. Teams, die ein Gateway nutzen, können häufig in chinesischen Yuan aufladen; die genauen Gebühren und Gutschriftregeln finden Sie auf der Preisübersicht. Preise werden angepasst; maßgeblich ist die Anzeige zum Zeitpunkt der Bestellung.

4. SDK installieren und erste curl-Anfrage senden

Installieren Sie zunächst das offizielle Python-SDK:

python3 -m pip install --upgrade openai
export OPENAI_API_KEY="sk-IHR-KEY"
export OPENAI_BASE_URL="https://api.openai.com/v1"
export OPENAI_MODEL="Modellname aus Preisübersicht oder offizieller Dokumentation"

Rufen Sie dann die Responses API mit curl auf, um Adresse, Key und Netzwerkverbindung zu prüfen:

curl -sS "$OPENAI_BASE_URL/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$OPENAI_MODEL"'",
    "input": "Erkläre in einem Satz, was ein API-Gateway ist."
  }'

Schreiben Sie den Modellnamen nicht aus dem Gedächtnis, sondern kopieren Sie einen aktuell verfügbaren Namen aus der Preisübersicht oder der offiziellen Dokumentation in die Umgebungsvariable OPENAI_MODEL. Ein Status 200 mit Ausgabe im Antwortkörper zeigt, dass die Verbindung steht. Bei 401 prüfen Sie zuerst den Key, bei 404 zuerst Base URL und Modellnamen.

5. Erster Aufruf in Python

Das folgende Beispiel sendet eine minimale Anfrage an die Responses API und gibt den Text aus:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://api.openai.com/v1"),
)

resp = client.responses.create(
    model=os.environ["OPENAI_MODEL"],
    input="Beschreibe in drei Sätzen, wo die Grenzen deiner Fähigkeiten liegen.",
)

print(resp.output_text)

Unterstützt Ihr Framework nur Chat Completions, ersetzen Sie den Aufruf durch client.chat.completions.create(...) und legen die Nachrichten in messages ab. Die beiden Schnittstellen verwenden unterschiedliche Pfade; beim Mischen entstehen am häufigsten 404-Fehler.

6. Nutzung und Abrechnung verstehen

Die Usage-Seite der Konsole zeigt den Verbrauch üblicherweise nach Projekt, Modell und Zeitraum und unterscheidet Input und Output. In der Anfangsphase empfiehlt es sich, täglich hineinzusehen und besonders zu prüfen:

  • welches Projekt Verbrauch erzeugt;
  • wie sich Input und Output verteilen;
  • ob es ungewöhnliche Wiederholungsversuche nach Fehlern gibt;
  • ob Budgetwarnungen greifen.

Die Request-ID aus der Antwort sollte im Log erhalten bleiben. Bei Abrechnungsfragen oder Störungen ist sie das erste Hilfsmittel, mit dem der Anbieter das Problem nachvollziehen kann. Zusätzlich sollte die Anwendung festhalten, welcher Nutzer, welches Funktionsmodul und welche Request-ID zusammengehören. Sonst zeigt die Rechnung nur eine Gesamtsumme ohne Zuordnung.

7. 401 und 429 analysieren

401 bedeutet, dass die Identität nicht akzeptiert wird. Prüfen Sie der Reihe nach: Enthält der Request-Header Bearer? Hat der Key zusätzliche Leerzeichen oder Zeilenumbrüche? Wurde der Key gelöscht oder ist sein Projekt deaktiviert? Wird ein Gateway-Key versehentlich an die offizielle Adresse gesendet? Klären Sie vor einem Key-Wechsel, wohin die Anfrage tatsächlich geht, sonst bleibt die Fehlersuche ohne Ergebnis.

429 hat zwei Bedeutungen: Ratenbegrenzung und unzureichendes Guthaben. Lesen Sie Fehlercode und Antwort-Header, statt pauschal die Geschwindigkeit zu drosseln. insufficient_quota deutet meist auf Guthaben oder Kontingent hin und erfordert eine Aufladung oder Anpassung der Projektgrenze; nur ratenbezogene Fehler eignen sich für exponentielles Backoff. Wiederholungen sind bei 429, 5xx und Netzwerkfehlern sinnvoll; bei 400, 401, 403 und 404 verschwenden sie nur Kontingent. Eine ausführlichere Fehlersuche mit einer Tabelle häufiger Fehlerbilder finden Sie in unserem Leitfaden für Claude Code.

8. Direkte Verbindung oder kompatibles Gateway

Kriterium Direkte Verbindung OpenAI-kompatibles Gateway
Endpunkt https://api.openai.com/v1 Base URL des Gateways, meist ebenfalls mit /v1
Konto und Zahlung Offizielles Konto, offiziell unterstützte Zahlungswege Konto auf der Gateway-Seite, Aufladung in Yuan und Rechnungen möglich
Netzwerk Abhängig von lokalem Netz und grenzüberschreitender Verbindung Bietet meist einen in China erreichbaren Zugang
Modellauswahl Modelle von OpenAI Häufig mehrere Anbieter, maßgeblich ist die Preisübersicht
Abrechnung Offizielle Rechnung Guthaben und Verbrauch im Gateway-Konto
Störungen Offizieller Support Gateway prüft den Upstream; Nutzer behalten die Request-ID
Geeignet für Teams, die nur OpenAI nutzen und einen passenden Zahlungsweg haben Teams in China mit mehreren Modellen und dem Wunsch nach einer Sammelrechnung

Vergleichen Sie bei der Auswahl nicht nur den Stückpreis. Reibungslose Zahlung, klare Zuständigkeit bei Störungen und die Möglichkeit, Modelle kurzfristig zu wechseln, beeinflussen die langfristigen Kosten. Preise ändern sich; maßgeblich ist stets die Preisübersicht.

9. Wechsel zum kompatiblen Gateway: nur die Base URL ändern

Der Umstieg ist meist einfacher als erwartet, weil ein kompatibles Gateway dasselbe Anfrageformat verwendet. Gehen Sie so vor:

  1. Registrieren Sie sich im Gateway und erstellen Sie einen Key; der Einstieg erfolgt über die Registrierungsseite.
  2. Ändern Sie OPENAI_BASE_URL auf die Gateway-Adresse und behalten Sie /v1 bei.
  3. Tauschen Sie den Key gegen den Gateway-Key aus und mischen Sie die beiden Keys nicht.
  4. Kopieren Sie den Modellnamen aus der Preisübersicht des Gateways und verlassen Sie sich nicht auf die offizielle Bezeichnung.
  5. Rufen Sie zuerst /v1/models und eine minimale Anfrage auf, bevor Sie Produktionsverkehr umstellen.
  6. Behalten Sie die offizielle oder eine Ersatzroute als Fallback.

„OpenAI-kompatibel“ bedeutet, dass Anfrage- und Antwortformat kompatibel sind, nicht dass sämtliche Erweiterungen identisch funktionieren. Ob Dateien, Batch-Verarbeitung und Tool-Aufrufe unterstützt werden, prüfen Sie Punkt für Punkt in der Gateway-Dokumentation und setzen Sie nichts voraus. Details zum Kompatibilitätsumfang finden Sie in unserer Anleitung zur Gemini-API, die auch den Weg über einen OpenAI-kompatiblen Endpunkt beschreibt.

10. Key-Sicherheit und Checkliste vor dem Livegang

Ein geleakter Key verursacht unmittelbar Kosten. Mindestanforderungen:

  • Keys nur in serverseitigen Umgebungsvariablen oder einem Secret-Management-Dienst ablegen, nicht im Frontend-Code und nicht in Git;
  • Keys nach Umgebung trennen; Test und Produktion teilen sich keinen Key;
  • für jeden Key Verantwortlichen und Zweck dokumentieren und ihn bei Austritt oder Projektwechsel deaktivieren;
  • im Log nie den vollständigen Key ausgeben, nur die letzten vier Zeichen;
  • regelmäßig rotieren und bei auffälligen Aufrufen sofort sperren.

Vor dem Livegang Punkt für Punkt prüfen:

  • [ ] Konto, Organisation und Projekt sind eindeutig zugeordnet;
  • [ ] die Zahlungsmethode funktioniert und Budgetwarnungen sind eingerichtet;
  • [ ] Keys liegen in Umgebungsvariablen oder im Secret Management;
  • [ ] die Base URL enthält nur ein /v1;
  • [ ] eine minimale Anfrage liefert 200 mit sinnvoller Ausgabe;
  • [ ] Backoff bei 429 und Wiederholungen bei 5xx sind konfiguriert;
  • [ ] das Nutzungsprotokoll enthält Request-ID, Modell und Laufzeit;
  • [ ] Ersatzroute und das Sperren von Keys sind erprobt.

11. Häufige Fragen

Sind API Key und ChatGPT-Abonnement dasselbe?

Nein. Abonnement und API werden getrennt abgerechnet; API Keys werden ausschließlich in der API-Plattform erstellt und verwaltet. Teams sollten bei der Erstattung beide Ausgaben auseinanderhalten.

Warum ist der vollständige Key nach der Erstellung nicht mehr sichtbar?

Der vollständige Schlüssel wird in der Regel nur einmal bei der Erstellung angezeigt; die Plattform speichert nur einen Teil der Zeichen zur Identifikation. Ist er verloren, erstellen Sie einen neuen Key und deaktivieren den alten.

Bis wohin reicht die Base URL?

Bis zur Domain plus /v1, ohne /chat/completions oder /responses. Den Pfad ergänzt das SDK oder die Anfrage selbst; ein zusätzliches Segment führt zu 404.

Kann ein Key für mehrere Projekte verwendet werden?

Technisch ja, organisatorisch ist davon abzuraten. Getrennte Keys pro Projekt oder Umgebung erlauben es, Berechtigungen zu steuern, Verbrauch zuzuordnen und bei einer Kompromittierung den Schaden zu begrenzen.

Brauchen Teams in China zwingend ein Gateway?

Nicht unbedingt. Entscheidend sind Zahlungswege, Netzqualität, Compliance-Anforderungen und ob mehrere Modelle benötigt werden. Wer ausschließlich OpenAI nutzt und über stabile Zahlung und Verbindung verfügt, kann direkt anbinden; Teams, die in Yuan abrechnen und einen einheitlichen Zugang wünschen, können anhand unserer Anleitung zur Gemini-API die Migration prüfen.

Nächste Schritte

Bringen Sie zuerst die minimale Anfrage zum Laufen und binden Sie dann die Fachlogik an. Wenn Sie Aufladung in Yuan und einen einheitlichen Zugang zu mehreren Modellen benötigen, beginnen Sie mit der Registrierung beim ZSQH AI Gateway; Modelle und Preise entnehmen Sie der Preisübersicht.

Weitere Artikel: