Fehlerbehebung
Nach Symptomen geordnetes Verzeichnis — finden Sie das beobachtete Problem und springen Sie zur Ursache.
Zugriff vor einem erneuten Versuch prüfen
- Prüfen Sie, ob die vorgesehene Zugangsberechtigung aktiv ist, und notieren Sie ihr Ablaufdatum.
- Vergewissern Sie sich, dass der Schlüssel die vorgesehene Gruppe verwendet. Zeitlich begrenzte Claude-Tarife verwenden Claude Unlimited; der Codex-Zugriff ist separat.
- Listen Sie die Modelle mit demselben Schlüssel auf, wählen Sie eine zurückgegebene ID aus und senden Sie eine kleine Anfrage.
Verwenden Sie Modelle und Schlüsselgruppen oder die Checkliste zur Agenteneinrichtung wenn Sie nicht sicher sind, welcher Schritt fehlgeschlagen ist.
Nichts funktioniert
Prüfen Sie zuerst die Grundlagen, bevor Sie andere Fehler untersuchen:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Prüfen Sie nach einer erfolgreichen Antwort auf die Modelllisten-Anfrage, ob das ausgewählte Modell in der Liste enthalten ist, und senden Sie eine kleine Generierungsanfrage. Die Generierung kann weiterhin aufgrund der Modellverfügbarkeit, der Zugangsberechtigung, von Limits oder der Client-Konfiguration fehlschlagen.
Nach Symptom
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
404 bei jedem Aufruf | Die Basis-URL verwendet die falsche /v1 Behandlung | Basis-URLs |
401 mit einem gerade erstellten Schlüssel | Falscher Header für das Format oder ein abschließendes Leerzeichen | Authentifizierung |
402 | Kein Guthaben oder Tarif abgelaufen | Guthaben aufladen · Tarife |
400 max_tokens | Messages erfordert max_tokens; Chat Completions hingegen nicht | Messages |
model_not_found | Falsche ID, falsche Schlüsselgruppe oder Modell für diesen Schlüssel nicht verfügbar | Modelle und Schlüsselgruppen |
| Streaming stellt eine Verbindung her, liefert aber nichts | Die Ereignisstruktur des anderen Formats wird geparst | Streaming |
| Antwort bricht mitten im Satz ab | stop_reason: max_tokens | Erhöhen Sie max_tokens |
| Funktioniert mit curl, schlägt im SDK fehl | Das SDK hängt seinen eigenen Pfad an Ihre Basis-URL an | Basis-URLs |
| Nutzung wird im Dashboard nicht angezeigt | Anfragen laufen über einen anderen Schlüssel oder Endpunkt | Prüfen Sie ANTHROPIC_API_KEY ist nicht gesetzt — Claude Code |
Häufige 429 | Zu hohe Parallelität des Agenten | Anfragelimits |
| Rechnung höher als erwartet | Wachsender Kontext über die Gesprächsschritte hinweg | Kontextverwaltung |
Den Fehlerinhalt lesen
Der Statuscode zeigt Ihnen die Problemkategorie; die error.type und error.message Felder zeigen Ihnen, welches Problem vorliegt. Protokollieren Sie den gesamten Antwortinhalt — ein 400 durch "missing max_tokens" und ein 400 durch "invalid role" erfordern völlig unterschiedliche Lösungen.
Weiterhin Probleme
Kontaktieren Sie support@aiprimetech.io mit dem Endpunkt, der Modell-ID, dem Statuscode und dem Fehlerinhalt. Geben Sie niemals Ihren API-Schlüssel an — falls Sie ihn bereits irgendwo eingefügt haben, widerrufen Sie ihn zuerst.