Viele scheitern beim ersten Kontakt mit der OpenAI API an drei Stellen: Sie wissen nicht, wo der Key erstellt wird, wie man Guthaben auflädt, und nach Erhalt des Keys nicht, welche Base URL eingetragen werden muss. Dieser Artikel führt den vollständigen Ablauf am Beispiel des ZSQH AI Gateway durch und zeigt Aufrufe mit Python, Node.js und curl.
Dieser Artikel behandelt die nutzungsbasierte API-Abrechnung, nicht das ChatGPT-Plus-Abonnement. Beides ist nicht dasselbe: Plus ist eine Mitgliedschaft für Web und App, die API ist eine Schnittstelle für Programme.
1. Konto beim ZSQH Gateway registrieren
Öffnen Sie das ZSQH AI Gateway, klicken Sie auf Registrieren, schließen Sie die E-Mail-Bestätigung ab und melden Sie sich an.
Nach der Registrierung gelangen Sie ins Kontrollzentrum. Drei Bereiche werden vor allem benötigt:
- API-Schlüssel: Keys erstellen und löschen.
- Wallet/Aufladen: Guthaben anzeigen und aufladen.
- Nutzungslogs: Modell, Tokens und Kosten jedes Aufrufs einsehen.
2. API Key erstellen
Rufen Sie die Seite „API-Schlüssel“ auf und klicken Sie auf Neu:
- Name: eindeutig nach Zweck, etwa
openai-api-testoderproduktion-backend. - Kontingent: zunächst eine niedrige Obergrenze setzen und nach erfolgreichem Test anpassen.
- Ablaufzeit: für Test-Keys 7 oder 30 Tage.
- Nach dem Speichern den Key kopieren. Er beginnt üblicherweise mit
sk-und wird nur einmal vollständig angezeigt.
Den Key nicht in Gruppenchats, Screenshots oder Git-Commits weitergeben. Bei Verdacht auf Kompromittierung den alten Key löschen und einen neuen erstellen.
3. Aufladen
Wählen Sie auf der Seite „Wallet“ eine Auflademethode und schließen Sie die Zahlung gemäß Anleitung ab. Nach Eingang wird das Guthaben im Kontrollzentrum angezeigt.
Für einen reinen Test genügt zunächst ein kleiner Betrag. Die Einzelpreise der Modelle unterscheiden sich deutlich; Details stehen in den Modellpreisen. Empfehlenswert ist, zuerst mit einem günstigen kleinen Modell zu testen und dann auf das Hauptmodell zu wechseln.
4. Base URL eintragen
Die OpenAI-kompatible Adresse des ZSQH Gateways lautet:
https://ai.zhongshangqihang.com/v1
Beachten Sie:
- OpenAI-kompatible Werkzeuge wie OpenAI SDK, Cursor, Chatbox, LobeChat und Dify tragen üblicherweise
https://ai.zhongshangqihang.com/v1ein. - Verlangt ein Werkzeug „API Base“, „Base URL“ oder „Endpoint“, immer diese Adresse eintragen.
/v1nicht vergessen und am Ende kein/chat/completionsergänzen; der Client hängt den Pfad selbst an.
5. Test mit curl
Den Key zuerst in eine Umgebungsvariable legen, damit er nicht in der Befehlshistorie landet:
export OPENAI_API_KEY="sk-IHR-SCHLUESSEL"
export OPENAI_BASE_URL="https://ai.zhongshangqihang.com/v1"
Dann aufrufen:
curl "$OPENAI_BASE_URL/chat/completions" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [
{"role": "user", "content": "Erklären Sie in einem Satz, was ein API-Gateway ist."}
]
}'
Enthält die JSON-Antwort choices, funktionieren Key und Base URL. Maßgeblich für den Modellnamen ist die aktuelle Anzeige in den Modellpreisen; ein falscher Modellname führt üblicherweise zu model not found.
6. Aufruf mit Python
OpenAI SDK installieren:
pip install openai
Beispiel:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url="https://ai.zhongshangqihang.com/v1",
)
response = client.chat.completions.create(
model="gpt-5",
messages=[
{"role": "system", "content": "Sie sind ein knapper technischer Assistent."},
{"role": "user", "content": "Erklären Sie, was ein Token ist."},
],
)
print(response.choices[0].message.content)
7. Aufruf mit Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: "https://ai.zhongshangqihang.com/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5",
messages: [{ role: "user", content: "Schreiben Sie eine JavaScript-Debounce-Funktion." }],
});
console.log(response.choices[0].message.content);
8. Häufige Fehler
| Fehler | Ursache | Vorgehen |
|---|---|---|
401 (nicht authentifiziert) |
Key falsch, gelöscht oder Bearer fehlt | Key neu kopieren, Request-Header prüfen |
404 Not Found |
Base URL ohne /v1 oder Pfad doppelt |
Nur bis /v1 eintragen |
model not found |
Modellname falsch oder nicht freigeschaltet | Modellname von der Preisseite kopieren |
insufficient quota |
Guthaben reicht nicht | Aufladen und erneut versuchen |
429 |
Parallelität oder Rate überschritten | Parallelität senken, später erneut versuchen |
| Leere Antwort | Parameter oder Modell nicht unterstützt | Format von messages und Modellfähigkeiten prüfen |
9. Sicherheit und Kosten
- Ein Key pro Person: Im Team keinen gemeinsamen Key verwenden, sonst lässt sich bei Problemen keine Ursache zuordnen.
- Kontingente setzen: Test-Keys niedrig, Produktions-Keys nach Budget.
- Kein Key im Frontend: Ein Key im Browser ist immer sichtbar; Frontend-Aufrufe müssen über den eigenen Backend laufen.
- Produktion mit Umgebungsvariablen/Secret-Manager: Keys nicht in Code oder Dockerfile schreiben.
- Regelmäßig rotieren: Wichtige Keys etwa alle 90 Tage austauschen.
- Nutzungslogs prüfen: Nach Modell, Projekt und Mitglied aufteilen und ungewöhnlichen Verbrauch finden.
10. Unterschied zwischen API und ChatGPT Plus
| Vergleichspunkt | ChatGPT Plus | OpenAI API |
|---|---|---|
| Nutzung | Chat in Web/App | Programmaufruf |
| Abrechnung | Festes Abonnement | Nach Tokenverbrauch |
| Zielgruppe | Privatnutzer im Alltag | Entwickler, Produkte, Teams |
| Kontingent | Tariflimits | Aufgeladenes Guthaben |
| Integration in Produkte | Nein | Ja |
Für reines Chatten ist ein Abonnement einfacher; soll das Modell in Produkte, Skripte, Agents oder Werkzeuge integriert werden, ist die API geeigneter.
Häufige Fragen
Ist der Key nach der Erstellung erneut sichtbar?
Üblicherweise wird er nur bei der Erstellung einmal vollständig angezeigt. Wer ihn nicht gespeichert hat, muss ihn löschen und neu erstellen.
Kann ein Key mehrere Modelle aufrufen?
Ja. Der Key ist der Identitätsnachweis, das Modell wird im Anfrageparameter angegeben. Welche Modelle verfügbar sind, steht auf der Preisseite.
Warum bleibt das Guthaben trotz erfolgreichem Aufruf unverändert?
Möglicherweise gibt es eine Verzögerung, oder es wurde ein Freikontingent bzw. Cache genutzt. Maßgeblich sind Nutzungslogs und Abrechnung.
Darf der Key an Kollegen weitergegeben werden?
Nicht empfohlen. Für Kollegen einen eigenen Key erstellen, um Limits, Prüfung und Deaktivierung zu erleichtern.
Nächste Schritte
Falls Sie noch kein Konto haben, registrieren Sie sich zuerst beim ZSQH AI Gateway, erstellen einen Test-Key und führen mit curl die erste Anfrage aus. Danach das Hauptmodell anhand der Modellpreise auswählen.
Weiterlesen:
