DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router ist ein praktisches Setup-Muster für Indie-Hacker, die DeepSeek-Modelle nutzen möchten, ohne jede Anbieterentscheidung in eine neue SDK-Integration zu verwandeln.
Es gibt zwei saubere Wege. Der direkte DeepSeek-Pfad verwendet einen DeepSeek-API-Schlüssel, DeepSeeks OpenAI-kompatible Base-URL und einen DeepSeek-Modellnamen. Der Router-Pfad verwendet die OpenAI-kompatible Base-URL von Flatkey, einen Flatkey-API-Schlüssel und die DeepSeek-Modell-ID, die für Ihr Konto verfügbar ist. Beide können funktionieren. Die richtige Wahl hängt davon ab, ob DeepSeek Ihre einzige Modellfamilie ist oder nur ein Weg in einem Multi-Model-Produkt.
Dieser Leitfaden zeigt, wie Sie DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router einrichten, wie Sie den direkten Provider-Pfad debuggbar halten und was Sie vor dem Wechsel des Produktionsverkehrs überprüfen sollten.
Schnelle Antwort: DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router
Für eine Anwendung im OpenAI-Stil gibt es für den DeepSeek-API-Zugriff zwei praktische Wege.
| Entscheidung | Direkte DeepSeek-API | DeepSeek über Flatkey |
|---|---|---|
| API-Schlüssel | DeepSeek-API-Schlüssel | Flatkey-API-Schlüssel |
| Base-URL | https://api.deepseek.com |
https://router.flatkey.ai/v1 |
| Option im Anthropic-Format | https://api.deepseek.com/anthropic |
Verwenden Sie die Flatkey-API-Form, die Ihr Pfad unterstützt |
| Aktuelle DeepSeek-Modellnamen zum Prüfen | deepseek-flash, deepseek-v4-pro |
Für Ihr Konto zugängliche DeepSeek-Modell-IDs aus Flatkeys /v1/models und dem Modellverzeichnis |
| Am besten geeignet für | Einen nur auf DeepSeek ausgerichteten Prototyp oder eine anbieterspezifische Integration | Eine Multi-Model-App, die einen Client, einen Schlüssel, eine Nutzungsprüfung und einfachere Fallbacks möchte |
| Operations-Check | DeepSeek-Dashboard, Provider-Dokumentation, aktuelle Preistabelle | Flatkey-Modellliste, Nutzungsprotokolle, Preisseite, Statusseite und Rollback-Manifest |
Verwenden Sie den direkten Pfad, wenn DeepSeek das einzige Modell ist, das Sie benötigen, und die Kontrolle auf Provider-Ebene am wichtigsten ist. Verwenden Sie Flatkey, wenn DeepSeek neben GPT, Claude, Gemini, Qwen, Medienmodellen oder Coding-Agent-Routen hinter demselben OpenAI-kompatiblen Client steht.
Was DeepSeek zur API-Kompatibilität bestätigt
In den aktuellen API-Dokumenten von DeepSeek steht, dass die DeepSeek-API ein API-Format verwendet, das mit OpenAI und Anthropic kompatibel ist. Die Base-URL im OpenAI-Format lautet:
https://api.deepseek.com
DeepSeek dokumentiert auch eine Base-URL im Anthropic-Format:
https://api.deepseek.com/anthropic
In denselben Dokumenten werden deepseek-flash und deepseek-v4-pro als Modelloptionen aufgeführt. Dort steht auch, dass die älteren Namen deepseek-v4-flash und deepseek-v4-flash-vision-exp aus Kompatibilitätsgründen weiterhin akzeptiert werden, diese Anfragen jedoch von DeepSeek-V4.1-Flash bedient und zum Flash-Preis abgerechnet werden. Behandeln Sie die alten Namen für neuen Code als Migrationsrisiko und nicht als Namen, die Sie in ein neues Produkt übernehmen sollten.
Die Preisseite von DeepSeek beschreibt deepseek-flash derzeit als DeepSeek-V4.1-Flash und deepseek-v4-pro als DeepSeek-V4-Pro-0813. Außerdem werden eine Kontextlänge von 1 Mio. und eine maximale Ausgabe von 384K aufgeführt; JSON-Ausgabe, Tool-Aufrufe, Responses API und Anthropic API-Unterstützung werden für beide Modelle angezeigt. Vision-Unterstützung ist für Flash aufgeführt, für Pro jedoch nicht. Prüfen Sie die aktuelle DeepSeek-Preisseite, bevor Sie exakte Preise in Ihrer eigenen Doku veröffentlichen, da die Tabelle Spitzen- und Nebenlast-Tokenpreise verwendet.
Was Flatkey verändert
Flatkey macht die Wahl einer gültigen DeepSeek-Modell-ID nicht überflüssig. Es ändert nur, wo die Route konfiguriert wird und wo Sie das Ergebnis überprüfen.
Die Schnellstart- und Modell-API-Dokumentation von Flatkey verwendet diese OpenAI-kompatible Basis-URL:
https://router.flatkey.ai/v1
Der /v1/models-Endpunkt von Flatkey gibt die für Ihr Konto verfügbaren Modell-IDs in einem OpenAI-kompatiblen Format zurück. Die Nutzungsdokumentation von Flatkey sagt, dass jede Anfrage mit dem verwendeten Modell, den Eingabe- und Ausgabe-Token-Zahlen, den Kosten, dem Zeitstempel, dem API-Schlüssel und dem Status geprüft werden kann. Das macht DeepSeek API Access Through an OpenAI-Compatible Router einfacher zu betreiben, wenn DeepSeek nur eine Option unter mehreren Modellen ist.
Der Router-Eintrag der Route sollte explizit sein:
deepseek_route:
provider_access_layer: flatkey
base_url: https://router.flatkey.ai/v1
api_key_source: FLATKEY_API_KEY
candidate_models:
- deepseek-flash
- deepseek-v4-pro
verify_before_launch:
- account_accessible_v1_models
- live_model_directory
- pricing_page_units
- usage_log_readback
- fallback_or_rollback_policy
Verstecken Sie den Modellnamen nicht als String im Anwendungscode. Legen Sie ihn in einer Konfigurationsdatei oder einem Modell-Manifest ab, damit ein DeepSeek-Modell-Update eine überprüfbare Änderung ist und kein Notfall-Deployment.
Schritt 1: Direktes DeepSeek oder einen Router wählen
Beginnen Sie mit der operativen Entscheidung, nicht mit dem SDK.
| Frage | Direktes DeepSeek reicht normalerweise aus, wenn... | Ein Router ist normalerweise besser, wenn... |
|---|---|---|
| Rufen Sie nur DeepSeek auf? | Ja, das Produkt ist ausschließlich DeepSeek. | Nein, DeepSeek ist eine Route neben anderen Anbietern. |
| Benötigen Sie anbieterspezifische Steuerungen? | Ja, Ihr Team möchte DeepSeek-native Einstellungen und Abrechnungsprüfung. | Nein, Ihre App möchte eine gemeinsame Zugriffsschicht und gemeinsame Protokolle. |
| Werden Benutzer oder Jobs Modelle wechseln? | Nein, ein festes Modell reicht aus. | Ja, Workloads können zwischen DeepSeek, Qwen, Gemini, Claude, GPT oder anderen Modellfamilien wechseln. |
| Wer prüft Kosten und Fehler? | Ein Entwickler kann das DeepSeek-Konto überprüfen. | Sie benötigen ein einheitliches Nutzungsjournal über Schlüssel, Modelle und Umgebungen hinweg. |
| Was passiert, wenn die Route fehlschlägt? | Sie können die Funktion pausieren oder später erneut versuchen. | Sie benötigen Fallback-, Rollback- oder gestaffelte Rollout-Steuerungen. |
Für die meisten Indie-Hacker kann die erste Version einfach sein. Direktes DeepSeek ist für einen Single-Model-Prototypen in Ordnung. DeepSeek API Access Through an OpenAI-Compatible Router ist sauberer, sobald das Produkt Modelle vergleicht, Coding-Agents ausführt, Kunden mit unterschiedlichen Latenz- oder Kostenanforderungen bedient oder einen zentralen Ort zum Debuggen der Token-Nutzung benötigt.
Schritt 2: Den Flatkey OpenAI-Client einrichten
Wenn Ihr Projekt bereits das OpenAI-SDK verwendet, besteht die Router-Einrichtung größtenteils aus einer Änderung von Base-URL und Schlüssel.
Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url="https://router.flatkey.ai/v1",
)
Node.js:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1",
});
Die direkte DeepSeek-Variante verwendet dieselbe OpenAI-ähnliche Client-Struktur, verweist aber auf DeepSeek:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
Bewahren Sie beide Schlüssel in Umgebungsvariablen oder in einem Secret-Storage auf. Committen Sie niemals FLATKEY_API_KEY, DEEPSEEK_API_KEY oder eine Staging-Überschreibung ins Repository.
Schritt 3: Überprüfen Sie die Modell-ID vor der ersten Anfrage
DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router sollte mit der Modell-Ermittlung beginnen, nicht mit einem kopierten Modellstring.
Fragen Sie bei Flatkey den Router, auf welche Modell-IDs Ihr Konto zugreifen kann:
curl https://router.flatkey.ai/v1/models \
-H "Authorization: Bearer $FLATKEY_API_KEY"
Bestätigen Sie dann den Kandidaten im Live-Modellverzeichnis und auf der Preisseite von Flatkey. Für DeepSeek direkt bestätigen Sie den Modellnamen in der DeepSeek-Dokumentation und auf der Preisseite. Zum Zeitpunkt dieser Quellprüfung verweisen die DeepSeek-Dokumente neuen Code auf deepseek-flash und deepseek-v4-pro, warnen jedoch davor, dass alte V4-Flash-Aliase Kompatibilitätsnamen sind.
Erstellen Sie ein kleines Manifest:
models:
deepseek_default:
id: deepseek-flash
route: flatkey
base_url: https://router.flatkey.ai/v1
use_for:
- coding_assistant
- structured_extraction
- long_context_review
owner: product_engineering
rollback: previous_production_model
Dies ist der Prüfdatensatz für den DeepSeek-Pfad. Er bietet Ihnen einen Ort, um Modell-ID, Routenverantwortlichen, Anwendungsfall und Rollback-Ziel zu dokumentieren, bevor der Produktionsverkehr von der Route abhängt. Bewahren Sie ihn mit Ihrer Release-Checkliste auf, damit der DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router nach dem Launch überprüfbar bleibt.
Schritt 4: Erstellen Sie eine erste Chat Completion
Beginnen Sie mit einer kurzen deterministischen Anfrage. Dies ist ein Routentest, kein Benchmark.
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{"role": "system", "content": "Gib prägnante Implementierungshinweise zurück."},
{"role": "user", "content": "Erkläre in einem Satz, warum die base_url-Konfiguration wichtig ist."},
],
temperature=0.2,
max_tokens=120,
)
print(response.choices[0].message.content)
Wenn die Anfrage fehlschlägt, prüfen Sie in dieser Reihenfolge:
| Prüfung | Was sie erkennt |
|---|---|
base_url |
Verwechslung von Direktzugriff und Router, fehlendes /v1, falscher Provider-Pfad |
| API-Schlüssel-Variable | Leere Umgebungsvariable, falscher Schlüsseltyp, Staging-Schlüssel in der Produktion |
| Modell-ID | Veralteter Alias, Konto hat keinen Zugriff, Tippfehler |
| Endpunktstruktur | Abweichung zwischen Chat Completions, Responses und Anthropic Messages |
| Funktionsunterstützung | Annahmen zu Vision, Thinking Mode, JSON, Tools oder Streaming |
| Nutzungsprotokoll | Die Anfrage hat den Router nie erreicht, Provider-Fehler, Token-/Kostenabweichung |
Diese Reihenfolge verhindert einen häufigen Debugging-Fehler: Konfigurationsfehler als Modellfehler zu behandeln.
Schritt 5: Testen Sie die Funktionen, die Ihre App tatsächlich verwendet
OpenAI-kompatibel bedeutet nicht, dass jeder Provider, jedes Modell oder jeder Router-Pfad identisch funktioniert. Testen Sie die Funktionen, die für Ihre Arbeitslast wichtig sind.
| Funktion | Smoke-Test | Bestehensbedingung |
|---|---|---|
| Nicht-streamender Chat | Ein kurzer Prompt | Eine nutzbare Antwort mit Nutzungsdaten wird zurückgegeben |
| Streaming | Dasselbe Prompt mit aktiviertem Streaming | Chunks kommen in der richtigen Reihenfolge an und die UI schließt sauber |
| JSON-Ausgabe | Eine kleine Extraktionsaufgabe | Die Ausgabe validiert gegen Ihr Schema oder Ihren Reparaturpfad |
| Tool-Aufrufe | Ein einfaches Funktionsschema | Tool-Call-Felder lassen sich ohne benutzerdefinierte Workarounds parsen |
| Langer Kontext | Ein repräsentativer langer Input | Latenz, Kosten und Qualität bleiben akzeptabel |
| Vision | Bild-Prompt nur bei Verwendung eines visionfähigen Modells | Die Anfrage ist nur auf einem Pfad erfolgreich, der Vision unterstützt |
| Fehlerbehandlung | Ungültige Modell-ID in Staging | Die App protokolliert den Routing-Fehler, ohne Schlüssel offenzulegen |
Öffnen Sie nach jedem Flatkey-Test die Usage Logs. Die Anfrage sollte das erwartete Modell, Token-Zählungen, Status, Zeitstempel, API-Schlüssel, Latenz und Kosten anzeigen. Wenn nichts erscheint, bestätigen Sie die Basis-URL und den Schlüssel, die die Anfrage tatsächlich verwendet hat.
Schritt 6: Kosten nach akzeptierter Ausgabe normalisieren
Die veröffentlichten Tokenpreise von DeepSeek können attraktiv aussehen, aber der Tokenpreis ist nur ein Teil der Produktionskosten. Vergleichen Sie nach der akzeptierten Ausgabe.
Verwenden Sie dieses Arbeitsblatt:
| Metrik | Warum sie wichtig ist |
|---|---|
| Input-Token | Prompts mit langem Kontext können die Kosten dominieren. |
| Output-Token | Agenten- und Coding-Aufgaben können deutlich längere Antworten erzeugen als Chat-Aufgaben. |
| Cache-Verhalten | Eingaben mit Cache-Hit und Cache-Miss können unterschiedlich bepreist werden. |
| Retry-Rate | Ein günstiger Pfad wird teuer, wenn er wiederholte Wiederholungen benötigt. |
| Ablehnungsrate | Ungültiges JSON, schwache Tool-Aufrufe oder Antworten von geringer Qualität sollten dem Pfad angerechnet werden. |
| Fallback-Nutzung | Fallback-Traffic muss sichtbar sein und darf nicht als Rundungsfehler behandelt werden. |
| Manuelle Korrekturzeit | Manuelle Nacharbeit ist Teil der tatsächlichen Produktkosten. |
Die praktische Formel:
accepted_output_cost =
(successful_request_cost + retry_cost + fallback_cost + human_repair_cost)
/ accepted_outputs
Verwenden Sie DeepSeeks Live-Preisseite für direkte Anbieter-Einheiten. Verwenden Sie Flatkeys Live-Preisseite und Ihre Nutzungsprotokolle für Gebühren über den Router-Pfad. Kopieren Sie keine statische Preiszeile in App-Dokumente, ohne ein geprüftes Datum und eine zuständige Person für Aktualisierungen.
Schritt 7: Fügen Sie eine Rollback-Richtlinie hinzu
Der DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router sollte rückgängig gemacht werden können, bevor Nutzer davon abhängig werden.
deepseek_rollout:
environment: production
default_model: deepseek-flash
route: flatkey
start_percentage: 10
increase_when:
- accepted_output_rate >= 0.95
- p95_latency_ms <= 4500
- error_rate <= 0.02
- usage_log_present: true
- accepted_output_cost_within_budget: true
rollback_when:
- error_rate > 0.05
- schema_failures_above_threshold: true
- usage_log_missing: true
- unexpected_cost_spike: true
rollback_action:
set_model: previous_production_model
notify: engineering_owner
Diese Richtlinie erfordert kein Platform-Team. Sie erfordert einen Routenverantwortlichen, ein Model-Manifest, eine Gewohnheit zur Nutzungsprüfung und einen Staging-Test, bevor Sie den Traffic erhöhen.
Wo das in Flatkey passt
Flatkey passt, wenn DeepSeek Teil eines breiteren Model-Routing-Workflows ist:
- Sie verwenden bereits OpenAI-kompatible SDKs und möchten eine einzige Base-URL für mehrere Modellfamilien.
- Sie benötigen separate Keys oder Kontingente für Entwicklung, Staging, Produktion oder Coding-Agents.
- Sie möchten DeepSeek, Qwen, Gemini, Claude, GPT und andere Modelle über einen gemeinsamen Modellkatalog und einen gemeinsamen Nutzungsworkflow prüfen.
- Sie benötigen einen Rollback-Pfad, wenn sich eine Modell-ID, Preiseinheit, Funktion oder ein Provider-Route ändert.
Beginnen Sie mit dem Flatkey API-Quickstart, verwenden Sie den Migrationsleitfaden für die OpenAI-API-Alternative, wenn Sie direkte Anbieteraufrufe ersetzen, und kombinieren Sie diese Checkliste mit den DeepSeek-vs-Qwen-API-Routing-Prüfungen, wenn kostenkritische Workloads regionale Anbieter vergleichen.
Für Produktionsentscheidungen prüfen Sie das Live-Flatkey-Modellverzeichnis, die Preisseite und die Statusseite. Für das Verhalten der DeepSeek-Modelle und die direkte Anbieter-Preisgestaltung prüfen Sie an dem Tag, an dem Sie live gehen, die API-Dokumentation und die Preisseite von DeepSeek.
Abschließende Checkliste für den DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router
Bevor Sie den DeepSeek-API-Zugriff für Nutzer bereitstellen, bestätigen Sie:
- Die Modell-ID ist in den aktuellen DeepSeek-Dokumenten und in der für das Flatkey-Konto zugänglichen Modellliste enthalten.
- Direkte DeepSeek-Tests verwenden
https://api.deepseek.comund einen DeepSeek-API-Schlüssel. - Flatkey-Router-Tests verwenden
https://router.flatkey.ai/v1und einen Flatkey-API-Schlüssel. - Sie verwenden
deepseek-v4-flashoderdeepseek-v4-flash-vision-expnicht als neuen Produktivmodellnamen. - Chat, Streaming, JSON-Ausgabe, Tool-Aufrufe, langer Kontext und Vision werden separat getestet, wenn Ihre Anwendung sie benötigt.
- Die Nutzungsprotokolle zeigen die erwartete Modell-ID, den Status, die Token-Zahlen, den Zeitstempel, die Latenz, den API-Schlüssel und die Kosten.
- Die Kosten werden nach akzeptierter Ausgabe normalisiert, nicht nur nach dem angegebenen Token-Preis.
- Rollback ist eine Konfigurationsänderung, kein Notfall-Umschreiben des Codes.
- Provider-Schlüssel werden in Umgebungsvariablen oder im Secret-Storage gespeichert, niemals im Code.
DeepSeek API-Zugriff über einen OpenAI-kompatiblen Router ist ein einfaches Integrationsmuster, wenn die Route explizit ist. Verwenden Sie direktes DeepSeek, wenn Sie nur DeepSeek benötigen. Verwenden Sie Flatkey, wenn DeepSeek Teil eines Multi-Model-Produkts ist, das einen Client, eine Base-URL, einen Nutzungszyklus und einen sauberen Rollback-Pfad benötigt.
Häufig gestellte Fragen
Unterstützt DeepSeek die OpenAI API?
Die aktuellen DeepSeek-Dokumente sagen, dass die DeepSeek-API ein mit OpenAI und Anthropic kompatibles API-Format verwendet. Die Base-URL im OpenAI-Format lautet https://api.deepseek.com.
Wie lautet die Flatkey-Base-URL für den Zugriff auf die DeepSeek API?
Verwenden Sie https://router.flatkey.ai/v1 für die mit OpenAI kompatible API von Flatkey. Wählen Sie dann eine aktuelle DeepSeek-Modell-ID aus der für Ihr Konto zugänglichen Antwort von /v1/models und dem Live-Flatkey-Modellverzeichnis.
Kann ich für DeepSeek über Flatkey dasselbe OpenAI SDK verwenden?
Ja. Konfigurieren Sie das OpenAI SDK mit einem Flatkey-API-Schlüssel und https://router.flatkey.ai/v1 als Base-URL. Die Anfrage behält die vertraute Chat-Completions-Struktur für kompatible Modelle bei.
Welchen DeepSeek-Modellnamen sollte neuer Code verwenden?
Prüfen Sie vor dem Rollout die aktuellen DeepSeek-Dokumente. Zum Zeitpunkt dieser Prüfung listet DeepSeek deepseek-flash und deepseek-v4-pro; es sagt, dass ältere V4-Flash-Namen aus Kompatibilitätsgründen akzeptiert werden, aber von DeepSeek-V4.1-Flash bereitgestellt werden.
Sollte ich exakte DeepSeek-Preise in meinen eigenen App-Dokumenten veröffentlichen?
Nur, wenn Sie das Prüfdatum und die verantwortliche Person für Aktualisierungen angeben. Die Preiseseite von DeepSeek verwendet Spitzen- und Nebenzeiten-Token-Raten, und die Verfügbarkeit der Flatkey-Route oder Preis-Einheiten sollten auf den Live-Preis- und Modellseiten von Flatkey überprüft werden.
