Basis-URLs
Die eine Einstellung, über die alle stolpern: welche URL der jeweilige Client erwartet, mit und ohne das Suffix /v1.
Fast jede fehlgeschlagene Integration geht auf einen Fehler bei der Basis-URL zurück. Diese Seite zeigt genau, was Sie einstellen müssen.
Die Regel
| Client | Basis-URL festlegen auf | Ruft dann auf |
|---|---|---|
| Anthropic SDK (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| OpenAI SDK (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Anthropic-Clients: ohne
/v1. OpenAI-Clients: mit /v1. Das Anthropic SDK hängt /v1/messages an die von Ihnen angegebene Basis-URL an; das OpenAI SDK hängt nur /chat/completionsan. Wenn Sie /v1 an eine Anthropic-Basis-URL anhängen, werden Anfragen an /v1/v1/messagesgesendet, was zu einem HTTP-Fehler „Not Found“ führt.So erkennen Sie, welchen Fehler Sie gemacht haben
| Sie sehen | Bedeutung |
|---|---|
404 und der Pfad enthält /v1/v1/ | Sie haben /v1 an eine Basis-URL im Anthropic-Stil angehängt. Entfernen Sie es. |
404 bei /chat/completions ohne /v1 | Sie haben /v1 in einer Basis-URL im OpenAI-Stil weggelassen. Fügen Sie es hinzu. |
404 bei /v1/chat/completions von einem Anthropic-Tool | Das Tool verwendet Messages, nicht Chat Completions. Verwenden Sie die Anthropic-Basis-URL und den entsprechenden Endpunkt. |
| Die Verbindung funktioniert, aber jeder Aufruf liefert einen HTTP-Fehler „Unauthorized“ | Die URL ist richtig, aber der Authentifizierungsheader passt nicht zum Format. Siehe Authentifizierung. |
Überprüfung ohne SDK
So prüfen Sie am schnellsten, ob URL und Schlüssel korrekt sind, bevor Sie die Ursache bei Ihrem Framework suchen:
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 bedeutet, dass sowohl URL als auch Schlüssel korrekt sind und jedes verbleibende Problem in Ihrer Client-Konfiguration liegt.