Base-URL, Schnittstellen und Authentifizierung

Dokumentation gepflegt von 1ZheAI. Quellen und Korrekturen.

Fehler gefunden? Support kontaktieren mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

Alle Anfragen gehen an dieselbe Domain, aufgeteilt in zwei Pfad-Sätze je nach Protokoll.

text

https://1zheai.com

Verfügbare Schnittstellen

Schnittstelle	Protokoll	Zweck
POST /v1/messages	Anthropic-nativ	Konversation. Claude Code, Anthropic SDK, Cline (Anthropic-Modus) nutzen diesen
POST /v1/chat/completions	OpenAI-kompatibel	Konversation. OpenAI SDK, Cursor, Cherry Studio (OpenAI-Modus) nutzen diesen
GET /v1/models	OpenAI-kompatibel	Listet die Modelle auf, die mit deinem API-Schlüssel (API key) nutzbar sind
POST /v1/messages/count_tokens	Anthropic-nativ	Berechnet die Token-Anzahl eines Eingabetexts, erzeugt keine Konversation, keine Abrechnung

Der Anfrage-Body von count_tokens ist identisch mit dem von /v1/messages (model, messages, optional mit system und tools); die Antwort enthält nur ein Feld:

json

{"input_tokens":19}

count_tokens zählt nur den von dir gesendeten Inhalt. Bei tatsächlichen Aufrufen über SDK, curl oder Drittanbieter-Tools wird zusätzlich ein System-Prompt mitgesendet, der nach Eingabe-Token abgerechnet wird (Claude Code sendet keinen mit), siehe Abrechnung des System-Prompts.

Fähigkeiten wie Prompt Caching, extended thinking und Tool-Aufrufe, die Claude-spezifisch sind, funktionieren am stabilsten über das native /v1/messages. Die OpenAI-kompatible Schnittstelle eignet sich für Szenarien mit bestehendem OpenAI-Code, bei denen nur ein anderes Modell verwendet werden soll.

Ob /v1 angehängt werden muss

Verschiedene Tools verstehen die Base-URL unterschiedlich – das ist die häufigste Fallstricke beim Anbinden:

Tool / SDK	Eintragen	Grund
Claude Code (ANTHROPIC_BASE_URL)	https://1zheai.com	Das Tool hängt selbst /v1/messages an
Anthropic SDK (base_url)	https://1zheai.com	wie oben
OpenAI SDK (base_url)	https://1zheai.com/v1	Das SDK hängt nur /chat/completions an
Cursor (Override OpenAI Base URL)	https://1zheai.com/v1	wie OpenAI SDK
Cherry Studio	https://1zheai.com	hängt automatisch /v1/... an
Cline (OpenAI Compatible)	https://1zheai.com/v1	wie OpenAI SDK

Regel: Anthropic-Serie mit der Basisadresse eintragen, OpenAI-Serie bis zu /v1. Ein typisches Symptom eines falschen Eintrags ist 404.

Authentifizierungs-Header

Der API-Schlüssel wird im Header mitgeführt; beide Schreibweisen sind möglich:

Anthropic 原生

Anthropic 原生

x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json

Bearer（两种协议都支持）

Bearer（两种协议都支持）

Authorization: Bearer sk-你的Key
content-type: application/json

• Beim Aufruf von /v1/messages gemäß offiziellem Protokoll anthropic-version mitführen, aktueller Wert ist 2023-06-01. In der Praxis funktioniert es auch ohne, aber offizielle SDKs und Tools senden es mit – eigene Anfragen ebenfalls mitführen.
• Claude Code sendet in ANTHROPIC_AUTH_TOKEN Authorization: Bearer, in ANTHROPIC_API_KEY wird x-api-key gesendet; beide werden akzeptiert.
• Bei Bedarf an Beta-Funktionen den anthropic-beta-Header gemäß offizieller Dokumentation mitführen. Unbekannte Werte verursachen keinen Fehler, ob eine bestimmte Beta-Funktion wirkt, entscheidet sich am tatsächlichen Effekt in der Antwort.

Prüfen, ob der API-Schlüssel nutzbar ist

bash

curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer sk-你的Key"

Eine Modellliste in der Antwort bedeutet, dass API-Schlüssel und Adresse stimmen. Ein 401 deutet auf ein Problem mit dem API-Schlüssel hin; die Antwort sieht so aus (getestet am 2026-10-15):

json

{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}

Bei Anfragen an /v1/models mit den Headern x-api-key und anthropic-version wird eine Modellliste im Anthropic-Format zurückgegeben (data[].id, display_name, has_more); genau dieses Format liest die automatische Modellerkennung von Claude Code.

Weitere Fälle siehe Fehlercodes und Fehlersuche.

Ratenlimits

Derzeit werden für API-Schlüssel keine Ratenlimits gesetzt. Bei 429 liegt in der Regel hohe Auslastung beim Upstream vor – später erneut versuchen, bei Batch-Aufgaben exponentielles Backoff verwenden. Details unter Fehlercodes und Fehlersuche.

Netzwerk

Bei Verbindungs-Timeouts oder TLS-Fehlern zuerst das Netzwerk des Terminals prüfen: Wenn ein globaler Proxy aktiv ist, Proxy deaktivieren und direkt verbinden; in Firmennetzwerken mit Ausgangs-Whitelist muss 1zheai.com freigegeben werden.