---
title: "Base-URL, Schnittstellen und Authentifizierung"
description: "Base-URL, verfügbare Schnittstellen und Header-Schreibweise von 1折AI sowie, ob in verschiedenen Tools /v1 angehängt werden muss."
headingIds: {"Verfügbare Schnittstellen":"section-1","Ob /v1 angehängt werden muss":"section-2","Authentifizierungs-Header":"section-3","Prüfen, ob der API-Schlüssel nutzbar ist":"section-4","Ratenlimits":"section-5","Netzwerk":"section-6"}
---

<aside className="docs-publication" data-pagefind-ignore>

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
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](/de/docs/pricing-explained/#section-3).

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:

<CodeGroup>
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="Bearer（两种协议都支持）"
Authorization: Bearer sk-你的Key
content-type: application/json
```
</CodeGroup>

- 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](/de/docs/troubleshooting/).

## 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](/de/docs/troubleshooting/).

## 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.