Die DeepSeek API wird wegen niedriger Preise und starker chinesischer Sprachfähigkeiten vielfach im Kundenservice, beim Schreiben, für Code und bei der Datenanalyse eingesetzt. Dieser Artikel erklärt aus Sicht des ZSQH AI Gateway, wie Sie den Key erhalten, Guthaben aufladen, mit dem OpenAI SDK aufrufen und mit Drosselung umgehen.
Dieser Artikel verwendet die OpenAI-kompatible Schnittstelle als Beispiel. Die offizielle DeepSeek-Schnittstelle ist ebenfalls mit dem OpenAI SDK kompatibel, verwendet aber eine andere Base URL und andere Modellnamen; beides nicht vermischen.
1. Was die DeepSeek API leistet
Typische Einsatzfelder:
- chinesische Frage-Antwort-Systeme und Kundenservice-Bots;
- Zusammenfassung, Übersetzung und Umschreibung langer Texte;
- Codegenerierung und Codeerklärung;
- Datenanalyse und strukturierte Extraktion;
- Inferenzknoten in Agents und Workflows.
Übliche DeepSeek-Modelle sind deepseek-chat und deepseek-reasoner. Verfügbare Modellnamen, Kontextlängen und Preise richten sich nach der Seite Modellpreise.
2. Registrieren und Key erstellen
- ZSQH AI Gateway öffnen, registrieren und anmelden.
- Die Seite „API-Schlüssel“ aufrufen und auf Neu klicken.
- Namen wie
deepseek-testoderdeepseek-produktionvergeben. - Obergrenze und Ablaufzeit setzen.
- Key kopieren und an einem sicheren Ort speichern.
Test- und Produktions-Key getrennt anlegen. Der Produktions-Key gehört nicht in Frontend-Code.
3. Aufladen
Auf der Seite „Wallet“ aufladen. Nach Eingang zeigt das Kontrollzentrum das Guthaben an.
Beim ersten Einsatz zunächst einen kleinen Betrag aufladen und nach erfolgreichem Test an das tatsächliche Volumen anpassen. DeepSeek ist vergleichsweise günstig, aber langer Kontext und Batch-Aufgaben können das Guthaben dennoch schnell aufbrauchen.
4. Base URL und Modellnamen
Die OpenAI-kompatible Adresse des ZSQH Gateways:
https://ai.zhongshangqihang.com/v1
Beispielhafte Modellnamen:
deepseek-chat
deepseek-reasoner
Beachten Sie:
- Modellnamen richten sich nach der Preisseite; übernehmen Sie keine alten Namen aus der offiziellen Dokumentation.
- Bei der offiziellen DeepSeek-Schnittstelle lautet die Base URL
https://api.deepseek.com; beim Gateway gilt die obige Adresse. - Die beiden Base URLs nicht mischen, sonst treten 401/404 auf.
5. Aufruf mit Python
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://ai.zhongshangqihang.com/v1",
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "system", "content": "Sie sind ein technischer Assistent."},
{"role": "user", "content": "Erklären Sie in drei Sätzen, was eine Vektordatenbank ist."},
],
)
print(response.choices[0].message.content)
Wird der Reasoning-Prozess benötigt, auf deepseek-reasoner wechseln. Reasoning-Modelle sind meist langsamer und teurer; sie eignen sich für schwierige Aufgaben, nicht für jede Anfrage.
6. Aufruf mit curl
export DEEPSEEK_API_KEY="sk-IHR-SCHLUESSEL"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Schreiben Sie ein Python-Beispiel zum Einlesen einer CSV-Datei."}
]
}'
7. Drosselung und Stabilität
In Spitzenzeiten kann DeepSeek drosseln oder langsamer antworten. Empfehlungen für den Betrieb:
- Timeout und Wiederholungen setzen: nicht unbegrenzt warten; bei 429/5xx exponentiellen Backoff verwenden.
- Parallelität begrenzen: Batch-Aufgaben nicht auf einmal voll auslasten.
- Ersatzmodell vorbereiten: Für kritische Geschäfte ein Ersatzmodell oder einen Ausweichkanal konfigurieren.
- Fehlerquote überwachen: 401/429/5xx stündlich zählen und bei Auffälligkeiten den Kanal wechseln.
- Lange Texte aufteilen: Sehr langer Kontext ist langsam und teuer; zuerst zusammenfassen oder segmentieren.
8. Häufige Fehler
| Fehler | Ursache | Vorgehen |
|---|---|---|
401 |
Key falsch oder Bearer fehlt | Key und Request-Header prüfen |
404 |
Base URL falsch | Gateway-Adresse mit /v1 verwenden |
model not found |
Modellname falsch | Von der Preisseite kopieren |
429 |
Drosselung | Parallelität senken, wiederholen, Ausweichkanal nutzen |
insufficient quota |
Guthaben reicht nicht | Aufladen |
| Sehr langsame Antwort | Spitzenlast/langer Kontext | Kontext kürzen, Modell wechseln, wiederholen |
9. Offizieller Zugang oder Gateway
| Vergleichspunkt | Direkt beim Hersteller | ZSQH-Gateway |
|---|---|---|
| Zugang | Abhängig von der Netzumgebung | Einheitlicher Zugang, meist stabiler |
| Zahlung | Von DeepSeek unterstützte Methoden | Aufladung auf dieser Website |
| Modelle | Nur DeepSeek | Zusätzlich Claude, GPT, Gemini und weitere |
| Abrechnung | Offizielles Backend | Einheitliches Kontrollzentrum |
| Wechsel | Anbieterwechsel erfordert Codeänderungen | Modellname ändern genügt |
Wenn Sie ausschließlich DeepSeek nutzen, ein stabiles Volumen haben und der offizielle Zugang funktioniert, ist die Direktanbindung möglich. Für mehrere Modelle, einheitliche Abrechnung oder stabilen Zugang aus China ist das Gateway besser geeignet.
10. Sicherheitsempfehlungen
- Keys nicht in Frontend-Code oder öffentliche Repositories schreiben.
- Getrennte Keys für Test und Produktion anlegen.
- Obergrenzen setzen, um ungewöhnliche Aufrufe zu begrenzen.
- Regelmäßig Nutzungslogs prüfen und bei Auffälligkeiten sofort deaktivieren.
- Bei Austritt oder Rechnerwechsel alte Keys löschen.
Häufige Fragen
Ist die DeepSeek API kostenlos nutzbar?
Üblicherweise gibt es Startguthaben oder Aktionen für neue Nutzer, langfristig ist jedoch Aufladen erforderlich. Maßgeblich sind die offiziellen und die Bedingungen auf dieser Website.
Kann ein Key auch Claude aufrufen?
Im ZSQH Gateway kann ein Key mehrere freigeschaltete Modelle aufrufen; das Modell wird im Anfrageparameter angegeben. Details stehen auf der Preisseite.
Warum ist dasselbe Modell mal schnell und mal langsam?
Mögliche Ursachen sind Upstream-Last, Kontextlänge, Parallelität und Netz. Im Produktivbetrieb Timeouts, Wiederholungen und ein Ersatzmodell vorsehen.
Nächste Schritte
Registrieren Sie sich zuerst beim ZSQH AI Gateway, erstellen Sie einen deepseek-Test-Key, testen Sie mit curl und binden Sie die Anwendung anschließend an. Preise und Modellnamen richten sich nach den Modellpreisen.
Weiterlesen:
