DeepSeek-API-Schlüssel funktioniert nicht: Ursachen und Lösungen

Starte mit einem einzeiligen Test

Bevor du etwas in deiner App änderst, teste die API direkt. Eine curl-Anfrage zeigt, ob Schlüssel, URL und Modell zusammenarbeiten. Ersetze die Platzhalter durch Werte aus dem Dashboard und den Docs.

Copycurl -i https://YOUR-PROVIDER/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'

Das -i-Flag gibt die Statuszeile und Header aus, und die sind wichtiger als der Body. Wenn curl funktioniert und deine App nicht, liegt der Fehler in den App-Einstellungen. Wenn curl auch fehlschlägt, ist der Schlüssel, das Konto oder der Endpunkt das Problem.

Lies zuerst den Statuscode

Dies sind die häufigen Bedeutungen bei OpenAI-ähnlichen Providern. Jeder Provider dokumentiert seine eigenen Codes; prüfe die aktuellen Docs für Details.

Der Schlüssel selbst

Schlüssel sind lange Strings und sie brechen auf langweilige Weise. Füge den Schlüssel in einen Texteditor ein und suche nach einem Leerzeichen oder Zeilenumbruch am Ende, einem Anführungszeichen am Anfang oder einem Zeilenumbruch, den eine Chat-App eingefügt hat. Stelle sicher, dass der Header Authorization: Bearer KEY mit einem einzelnen Leerzeichen nach Bearer lautet. Wenn du den Schlüssel in einer Umgebungsvariable setzt, gib seine Länge in deiner App aus (nicht den Wert), um zu bestätigen, dass er geladen wurde.

Zwei weitere Fälle sind häufig. Erstens: Du hast einen Schlüssel erstellt, die Seite geschlossen und eine maskierte Version kopiert. Die meisten Dashboards zeigen einen Schlüssel nur einmal an, also erstelle einen neuen. Zweitens: Du nutzt einen Schlüssel eines Dienstes gegen die URL eines anderen Dienstes. Ein Schlüssel ist nur für den Anbieter, der ihn ausgestellt hat, gültig.

Guthaben, Abrechnung und kostenloses Guthaben

Viele API-Schlüssel funktionieren nur, solange das Konto Guthaben hat. Ein leeres Guthaben kann wie ein defekter Schlüssel aussehen. Öffne die Abrechnungsseite deines Anbieters und bestätige, dass du über Guthaben verfügst, dass eine Aufladung tatsächlich verbucht wurde und dass werbliches Guthaben nicht abgelaufen ist. Aufladungen per Krypto können einige Minuten dauern, bis sie erscheinen. Kartenzahlungen werden nicht mehr akzeptiert.

Wenn du vergleichen möchtest, wie ein anderer Prepaid-Dienst damit umgeht, ist unser Modell einfach: Du kaufst Guthaben, Aufrufe reduzieren es um $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token, fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, und das Guthaben verfällt nie. Du kannst das Guthaben mit GET /v1/balance oder über den X-Balance-USD-Header jeder Antwort abfragen.

Base URL und Modellname

Die häufigste Ursache in Tools wie SillyTavern, Janitor AI und Editor-Plugins ist eine leicht falsch eingegebene Base URL. Häufige Fehler: fehlendes /v1, ein verdoppeltes /v1/v1, die Verwendung von http statt https oder das Einfügen des vollständigen Pfads /chat/completions in ein Feld, das ihn bereits hinzufügt. Das Modellfeld ist die andere Falle. Es muss mit einer Modell-ID übereinstimmen, die der Anbieter auflistet. Liste sie mit GET /v1/models auf, wenn der Anbieter dies unterstützt, oder lies die aktuellen Docs.

Anleitungen für spezifische Tools findest du hier: Schlüssel in SillyTavern verwenden, in Janitor AI und in VS Code.

Ratenlimits und Parallelität

Ein Burst paralleler Anfragen kann einen 429 auslösen, auch bei einem gültigen Schlüssel. Suche nach einem Retry-After-Header und reduziere die Anfragrate. Ein minimaler Retry in Python sieht so aus:

Copyimport time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")

def ask(prompt):
    for attempt in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited")

Bei unserem Endpunkt erlaubt ein voller Schlüssel 8 parallele Anfragen und 300 Anfragen pro Minute. Eine gestreamte Anfrage belegt ihren Slot, bis das Streaming abgeschlossen ist. Der Fehlercode ist rate_limited oder concurrency, und eine vorübergehende Überlastung gibt 429 mit Retry-After: 5 zurück.

Netzwerk- und regionale Probleme

Wenn curl hängt oder zurücksetzt, liegt das Problem möglicherweise zwischen dir und dem Anbieter: ein Unternehmens-Proxy, ein VPN, DNS oder ein regionaler Block. Versuche ein anderes Netzwerk, prüfe, dass dein Proxy Authorization-Header durchlässt, und erhöhe dein Client-Timeout für lange Generierungen. Streaming-Antworten können auch von Proxys abgeschnitten werden, die puffern; teste mit stream: false, um die beiden Probleme zu trennen.

Eine Checkliste für fünf Minuten

1. Führe den curl-Test durch und notiere den Statuscode.
2. Erstelle einen neuen Schlüssel und teste ihn. Wenn er funktioniert, war der alte falsch kopiert oder widerrufen.
3. Prüfe das Guthaben und das Ablaufdatum.
4. Vergleiche Base URL und Modell-ID Zeichen für Zeichen mit den Docs des Providers.
5. Sende eine Anfrage ohne Streaming, Tools und kurzen Prompt. Füge Funktionen nacheinander hinzu.
6. Prüfe auf parallele Aufrufe. Wenn deine App mehrere Anfragen gleichzeitig sendet, senke die Konurrenz.
7. Versuche ein anderes Netzwerk oder schalte den VPN aus.
8. Prüfe die Response-Header, einschließlich der Request-ID. Das Support-Team findet deine Anfrage damit.

Schritt fünf findet eine überraschende Anzahl von Fehlern. Tool-Definitionen, die leicht ungültig sind, ein sehr großer max_tokens-Wert oder ein Body über der Größengrenze können alle Fehler zurückgeben, die wie Schlüsselprobleme aussehen. Auf unserem Endpunkt beträgt die Body-Grenze 8 MB, und jede Antwort enthält einen X-Request-Id-Header, den du zur Unterstützung zitieren kannst.

Richte einen Backup-Endpunkt ein

Ausfälle und Limits passieren bei jedem Anbieter, also halte einen zweiten OpenAI-kompatiblen Endpunkt in deiner Konfiguration. Unseres ist ein gehostetes Open-Weight-Modell, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die rechtmäßige Nutzung durch Erwachsene zu antworten. Es ist nicht die offizielle API von DeepSeek und es ist kein Router, also erwarte andere Antworten und anderes Verhalten. Das Umschalten erfordert zwei Einstellungen: Base URL https://api.deepseekapikey.com/v1 und Modell uncensored.

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Neue Nutzer können $0,50 an Testguthaben mit einem Klick auf der API-Schlüssel-Seite beanspruchen, gültig für 7 Tage. Aufladungen laufen von $20 bis $500 per Krypto; sieh dir die Preisseite und die Dokumentation für Details an.

Weitere Anleitungen

• DeepSeek API-Schlüssel: Kostenlos oder bezahlt? Echte Kosten
• DeepSeek API-Schlüssel in SillyTavern: Verbinde unsere API