Endpunkte & API-Pfade

Die API-Protokolle Anthropic und OpenAI von QCode.cc (der Gemini-Pfad ist derzeit nicht verfügbar), drei Zugriffsdomänen und die korrekte Angabe von BASE_URL

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Diese Seite fasst zusammen, wie QCode.cc drei API-Protokolle und drei Zugriffsdomänen bereitstellt, und wie Sie BASE_URL korrekt einrichten. Ein einzelner API-Key funktioniert über alle drei Protokolle hinweg — die Protokollauswahl erfolgt über den Request-Pfad, und unser Backend routet automatisch.

Der Key wird bei jeder Option gleich verwendet. Noch nicht gewählt? Lesen Sie Den passenden Tarif wählen und holen Sie sich dann im Dashboard Ihren Key.

1. API-Protokolle¶

QCode.cc ist mit den Protokollen Anthropic Messages und OpenAI kompatibel. Einen Pfad für das Google Gemini-Protokoll gibt es ebenfalls, doch QCode hat alle Gemini-Modelle vorübergehend aus dem Angebot genommen; der Pfad ist derzeit nicht verfügbar, und die Gemini-Hinweise unten dienen nur als Protokollreferenz:

Request-Bodies folgen dem jeweiligen offiziellen Schema (Anthropic POST /v1/messages, OpenAI POST /v1/chat/completions, OpenAI POST /v1/responses, Google POST /v1beta/models/{model}:generateContent).

Hinweis: /api, /claude und /openai/v1 sind Pfadpräfixe, keine eigenständigen Endpunkte. SDKs hängen automatisch /v1/messages, /chat/completions oder /responses an. Ein direkter Aufruf von curl https://api.qcode.cc/api liefert eine HTML-Landingpage zurück (HTTP 200) — das ist kein Fehler und belegt nicht, dass der Pfad funktioniert; verwenden Sie den POST-Selbsttest in Abschnitt 5 unten.

2. Welche Modelle funktionieren über welches Protokoll¶

Das Protokoll wird durch den Request-Pfad bestimmt, aber nicht jede Modellfamilie funktioniert über jedes Protokoll. Die folgende Tabelle ist die einzige maßgebliche Quelle; andere Seiten verweisen darauf.

🔴 Claude-Modelle funktionieren ausschließlich über das Anthropic-Protokoll. Setzt man claude-… in /openai/v1/chat/completions ein, lautet die Antwort:

{"error":{"code":"model_not_available_on_endpoint",
          "message":"Model 'claude-sonnet-5' is not available on this endpoint. Claude models are served only through the Anthropic Messages API: use a base URL ending in /api (or /claude) and send POST /v1/messages. OpenAI-compatible endpoints do not serve Claude models. / Claude 模型只能走 Anthropic Messages 接口：BASE_URL 以 /api（或 /claude）结尾，请求 POST /v1/messages；OpenAI 兼容接口不提供 Claude 模型。",
          "param":"model",
          "type":"invalid_request_error"}}

Diese Prüfung erfolgt vor der Authentifizierung — Sie erhalten diesen Fehler auch bei ungültigem Key. model_not_available_on_endpoint bedeutet also, dass Sie das falsche Protokoll gewählt haben, nicht dass Ihr Key ungültig ist; ein ungültiger Key liefert stattdessen Invalid API key. Verwechseln Sie die beiden nicht.

Die Einschränkung betrifft ausschließlich Claude, es ist keine pauschale „kein Protokollwechsel“-Regel:

• Die vier chinesischen Familien (GLM / Kimi / DeepSeek / Qwen) funktionieren über beide Endpunkte: den Anthropic- und den OpenAI-Chat-Endpunkt
• GPT-Modelle nutzen die beiden OpenAI-Endpunkte; über den Anthropic-Endpunkt funktionieren sie ebenfalls nicht

Was das bei der Tool-Auswahl bedeutet: Clients, die nur das OpenAI-Protokoll sprechen und keinen eigenen Anthropic-Endpunkt bieten (zum Beispiel DeepSeek-TUI und WorkBuddy), können Claude-Modelle über QCode nicht nutzen, GPT und die chinesischen Modelle funktionieren hingegen einwandfrei. Wählen Sie für Claude einen Client, der das Anthropic-Protokoll spricht (Claude Code, Cline, Zed oder den Anthropic-Pfad von Cursor).

3. Drei Zugriffsbereiche¶

Alle drei Bereiche bieten identische Funktionalitäten; sie unterscheiden sich nur im Netzwerk-Routing:

Ein einzelner API-Key funktioniert auf allen drei Bereichen – Sie können frei wechseln.

🇨🇳 Hinweis für Nutzer in China: Wir empfehlen asia.qcode.cc (Asien-Knoten: Korea / Taiwan / Hong Kong); wechseln Sie zu api.qcode.cc (global Route 53), falls instabil. Alle Bereiche berichten an probe.qcode.cc – geben Sie auf dieser Seite Ihren API-Key ein, um Request-Details, Kontextlänge, Nutzung und mehr zu prüfen.

4. BASE_URL-Spickzettel¶

Tragen Sie das Folgende je nach Ihrem Tool ein:

Anfragepfad von Codex: Codex hängt /responses direkt an base_url an, die tatsächliche Anfrage geht daher an /openai/responses; /openai/responses und /openai/v1/responses sind auf QCode gleichwertig (am 2026-10-27 getestet).

Warum zwei Formen für Gemini? Der google-Provider von OpenCode fügt /v1beta/ nicht automatisch an, daher muss die baseURL diesen Pfad enthalten (/gemini/v1beta). Gemini CLI und Googles offizielles @google/genai SDK fügen /v1beta/ automatisch an, daher endet die Basis-URL nur bei /gemini – wenn Sie /v1beta selbst anhängen, ergibt das /gemini/v1beta/v1beta/... und liefert 404 zurück.

⚠️ Gemini derzeit nicht verfügbar: QCode hat alle Gemini-Modelle vorübergehend aus dem Angebot genommen; die beiden Gemini-Basis-URL-Zeilen oben dienen nur als Protokollreferenz. Nutzen Sie stattdessen Claude, GPT oder die chinesischen Modelle. Unabhängig davon ist Gemini CLI am 2026-06-18 eingestellt worden (Tarife für Privatkonten); offiziell wird die Google Antigravity CLI empfohlen.

Desktop-Clients: Cherry Studio ermöglicht es Ihnen, alle vier oben genannten Protokolle als eigene Anbieter einzutragen – siehe Cherry Studio Integration. Für die Protokollunterstützung je Tool und ob Claude funktioniert, siehe Tool-Kompatibilitätsübersicht; für Abos vs. API-Keys, siehe Abos vs. API-Keys vs. QCode-Keys.

5. Selbsttest mit curl¶

Bevor Sie ein vollständiges SDK einbinden, können Sie den Pfad und die Netzwerkkonnektivität mit einem einfachen POST testen:

KEY="cr_your_key"

# Anthropic protocol path test
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
  -H "Authorization: Bearer $KEY"
# → 400 = path & key both OK (missing body is expected); 401 = invalid key

# OpenAI Chat Completions path test
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 / 401 as above

# OpenAI Responses (used by Codex)
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/responses \
  -H "Authorization: Bearer $KEY"
# → 400 / 401 as above

# Google Gemini protocol path test (QCode bietet Gemini derzeit nicht an; Pfad nicht verfügbar, nur zur Referenz)
curl -s -o /dev/null -w '%{http_code}\n' -X POST "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: $KEY"
# → 400 / 401 = path OK

Interpretation: Mit einem angegebenen Key bedeuten 400 (fehlender Body) oder 401 (Key-Problem), dass die Pfadzuordnung und das Netzwerk einwandfrei funktionieren; 404 bedeutet einen falschen Pfad-Präfix – korrigieren Sie ihn anhand der Tabelle in Abschnitt 4. Liefert eine Anfrage mit Key 402 mit einem code wie *_cost_limit_exceeded, sind Pfad und Key ebenfalls in Ordnung — das Kontingent dieses Keys ist nur aufgebraucht (siehe Fehlercode-Referenz). Hinweis: Wird einer dieser Pfade ohne Key aufgerufen, erhalten Sie eine HTML-Einführungsseite (HTTP 200) und keine Fehlermeldung – sehen Sie diese, wurde Ihr Key nicht übermittelt.

End-to-End-Test mit einem echten API-Key:

curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

Wenn Sie die Domain auf us.qcode.cc / asia.qcode.cc ändern und denselben Pfad beibehalten, sollte das gleiche Ergebnis erzeugt werden – dies bestätigt, dass der alternative Bereich für Sie nutzbar ist.

6. FAQ¶

F: Warum liefert curl https://api.qcode.cc/api eine HTML-Seite zurück?

A: /api ist ein Pfadpräfix und kein Endpunkt; Anfragen, die zu keiner API-Route passen, werden auf eine Landingpage umgeleitet (HTTP 200). Der vollständige Pfad lautet /api/v1/messages – prüfen Sie ihn mit dem POST-Selbsttest in Abschnitt 5 (ein 401 bedeutet, dass die Anfrage die Authentifizierung erreicht hat).

F: Gibt es einen Unterschied zwischen /api/v1/messages und /claude/v1/messages?

A: Nein. Beide Präfixe werden auf das Anthropic-Messages-Protokoll geroutet – verwenden Sie das Präfix, das Ihr SDK standardmäßig nutzt. Unsere Dokumentation verwendet standardmäßig /api, da die meisten SDKs aus dem Claude-Umfeld dieses Präfix erwarten.

F: Kann ich mit einem API-Key sowohl Claude als auch Codex (GPT) nutzen?

A: Ja. Keys sind protokollunabhängig; das Protokoll wird über den Anfragepfad bestimmt. /api/v1/messages steht für Anthropic und /openai/v1/responses für OpenAI Responses. Gemini-Modelle bietet QCode derzeit nicht an.

F: Sollte die baseURL für Gemini auf /v1beta enden oder nicht?

A: (QCode bietet Gemini derzeit nicht an; das Folgende dient nur als Protokollreferenz.) Das hängt vom Tool ab. Der google-Provider von OpenCode benötigt es (setzen Sie baseURL auf /gemini/v1beta), da er /v1beta/ nicht automatisch anhängt. Gemini CLI und das @google/genai-SDK von Google benötigen es nicht (setzen Sie die Base-URL auf /gemini) – das SDK hängt /v1beta/ selbst an, und ein manuelles Hinzufügen würde /gemini/v1beta/v1beta/... ergeben und einen 404-Fehler zurückliefern.

F: Welche Domain soll ich wählen?

A: Festlandchina → asia.qcode.cc (Asien-Knoten: Korea / Taiwan / Hongkong) oder api.qcode.cc (globales Route 53); Nordamerika / Europa → us.qcode.cc. Wechseln Sie bei Bedarf auf eine der anderen Domains, falls Ihre primäre Domain hängt.

F: Kann ich meinen eigenen Anfrageverlauf einsehen?

A: Ja. Anfragen, die über eine beliebige Domain (api.qcode.cc / asia.qcode.cc / us.qcode.cc) gesendet werden, werden an probe.qcode.cc gemeldet. Geben Sie dort Ihren API-Key ein, um die Anfrageliste, Modelle, Tokens und mehr einzusehen.

F: Soll ich in der BASE_URL einen abschließenden Schrägstrich angeben?

A: Nein. Die meisten SDKs hängen Pfade wie /v1/messages automatisch an; ein abschließender Schrägstrich würde //v1/messages ergeben und einen 404-Fehler verursachen.

Enterprise →