# 1折AI · Vollständige Dokumentation
# 1ZheAI-Dokumentation
Source: https://1zheai.com/de/docs/
Markdown: https://1zheai.com/de/docs/index.md
---
title: "1ZheAI-Dokumentation"
description: "Einstiege für Modell-API, einsatzbereite Konten und Abo-Aufladung, Kaufhinweise, Bestell- und After-Sales-Regeln."
headingIds: {"Modell-API-Anbindung":"section-1","Was möchtest du tun":"section-2","Nachschlagen und Support":"section-3","Häufigste Fragen vor der Nutzung":"section-4","Entwickler-Schnellreferenz":"section-5"}
---
Wählen Sie Ihre Aufgabe: eine Modell-API anbinden, ein KI-Konto kaufen oder ein Abonnement für ein vorhandenes Konto aktivieren.
Plattform, Abo-Stufe, Lieferumfang und Hinweise zur ersten Anmeldung bestätigen.Kontovoraussetzungen, erforderliche Unterlagen und den Freischaltungsablauf prüfen.Region, Gültigkeitsdauer, Einlösemethode und geltendes Konto bestätigen.Regeln zu Kündigung, Lieferungsstörungen, Kontosperre und Rückerstattung verstehen.
## Modell-API-Anbindung
1折AI bietet Claude- und OpenAI-/GPT-APIs und unterstützt Anthropic Messages, OpenAI Responses und Chat Completions. Zu den gängigen Endpunkten gehören: Anthropic-nativ `/v1/messages` sowie OpenAI-kompatibel `/v1/chat/completions`. Dein bestehender Code und deine Tools müssen in der Regel nur an zwei Stellen angepasst werden: Base URL und API-Schlüssel (API key).
```text
Anthropic Base URL https://1zheai.com
OpenAI Base URL https://1zheai.com/v1
API Key sk-...（在控制台创建）
```
Claude-Eingaben und -Ausgaben werden je nach Rabatt des jeweiligen Modells abgerechnet; Cache-Lese- und Cache-Schreibvorgänge erfolgen zum offiziellen Originalpreis ohne Rabatt. Preise und Abrechnungseinheiten für GPT, MiMo und Bildgenerierungsmodelle siehe[Modelle und Preise](https://1zheai.com/en/pricing/).
Claude, GPT, MiMo und Bildgenerierungsmodelle sind live; die vollständige Liste siehe[Unterstützte Modelle](/de/docs/models/).
## Was möchtest du tun
Claude Code, Codex CLI, Cursor, Cline, Cherry Studio und CC Switch. Zuerst den unterstützten Umfang prüfen, dann Schritt für Schritt konfigurieren.Mit Anthropic SDK, OpenAI SDK oder curl beginnen, dann mehr über Streaming-Ausgabe erfahren.Maschinenlesbare Dokumentation, Seitenübersicht und kopierbare KI-Anbindungsaufgabenbeschreibung.Registrieren, API-Schlüssel erstellen, erste Anfrage abschließen.
## Nachschlagen und Support
Endpunkte, Protokolle, Beispiele und Kompatibilitätsbereich nachschlagen.Gebühren, Aufrufprotokolle und Fehlerbehebungspfade einsehen.
## Häufigste Fragen vor der Nutzung
Rückgabefelder und Verbrauch prüfen; diese Prüfungen können die Modellherkunft nicht allein belegen.
Wie Cache aktiviert wird, wie Treffer eingesehen werden und wie viel günstiger es nach einem Treffer ist.
Was 401, 404, 429 bzw. 5xx bedeuten.
Zahlungsarten, 7-Tage-Rückerstattung, Rechnungsregeln.
## Entwickler-Schnellreferenz
| Deine Aufgabe | Direkt ansehen |
| --- | --- |
| Erstes Mal Code schreiben | [Vollständiges lauffähiges Beispiel](/de/docs/code-examples/) |
| Wechsel von einer anderen Plattform | [Migrationsleitfaden](/de/docs/migration/) |
| Modelle und Protokolle abfragen | [Modellabfrage](/de/docs/api-models/) · [API-Referenz](/de/docs/api-reference/) |
| Timeouts und Rate-Limits behandeln | [Timeout und Wiederholung](/de/docs/retries/) |
| Häufige Fragen nachschlagen | [Anbindungs-FAQ](/de/docs/faq/) |
---
# Schnellstart
Source: https://1zheai.com/de/docs/quickstart/
Markdown: https://1zheai.com/de/docs/quickstart.md
---
title: "Schnellstart"
description: "Erstelle einen 1zheai API-Schlüssel, rufe Claude / GPT mit curl oder SDK auf und integriere ihn in gängige Clients."
headingIds: {"Du kannst auch mit GPT beginnen":"section-1","Nächste Schritte":"section-2"}
---
Ziel: Innerhalb von 5 Minuten einen API-Schlüssel (API key) erhalten und die erste Claude- oder GPT-Anfrage abschließen.
Öffne [1zheai.com/register](https://1zheai.com/register?lng=de) zur Registrierung. Aufrufe werden nach Verbrauch vom Guthaben abgezogen, daher musst du zuerst aufladen. Das Guthaben wird in USD geführt; unterstützt werden WeChat, Alipay, Stripe (Bankkarte) und USDT. Die genaue Methode und die Betragslimits gelten laut der Bestellseite der Wallet. Innerhalb von 7 Tagen nach der Aufladung kannst du den ungenutzten Kapitalanteil über den ursprünglichen Weg zurückfordern; bereits verbrauchte Teile und Zahlungsabwicklungsgebühren werden nicht erstattet. Die Regeln findest du unter [Aufladung, Rückerstattung und Rechnungen](/de/docs/billing/).
Gehe in die [Konsole](https://1zheai.com/console?lng=de), klicke im linken Menü auf „API-Schlüssel“, dann oben rechts auf „API-Schlüssel erstellen“, vergebe einen Namen und speichere. Der API-Schlüssel beginnt mit `sk-`; klicke in der Liste auf das Kopiersymbol, um ihn zu kopieren und zu speichern. Details siehe [API-Schlüssel abrufen und verwalten](/de/docs/api-keys/).
Lege den API-Schlüssel in eine Umgebungsvariable und rufe dann die native Anthropic-Schnittstelle mit curl auf:
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}]
}'
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$body = @{
model = "claude-sonnet-5-5"
max_tokens = 128
messages = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
-Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
`ONEZHE_API_KEY` ist nur ein Beispielvariablenname; jeder Name ist möglich.
Bei Erfolg wird HTTP 200 mit einer Struktur zurückgegeben, die mit der offiziellen übereinstimmt. Achte auf zwei Stellen: `model`, ob es das von dir angefragte Modell ist, und die Token-Anzahl in `usage`. Unten ist die am 2026-10-15 real gemessene Antwort:
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
`input_tokens` ist um einige hundert höher als die Frage selbst; das sind die System-Prompts, die diese Art von Clients (curl, SDK, Drittanbieter-Tools) jeder Anfrage beifügen. Sie werden als Eingabe berechnet. Claude Code fügt keine bei, siehe [Abrechnung von System-Prompts](/de/docs/pricing-explained/#section-3).
Gehe dann im Konsole-Menü links zu „Aufrufprotokolle“, um diesen Vorgang zu sehen: Zeit, verwendeter API-Schlüssel (Spalte „Token“), Modell, Eingabe-/Ausgabe-Token, Cache-Lese-/Schreibvorgänge und Kosten.
## Du kannst auch mit GPT beginnen
Wenn du das OpenAI SDK verwendest oder Codex integrieren möchtest, kannst du direkt das GPT-Protokoll wählen. Richte zuerst im selben Terminal die oben genannte `ONEZHE_API_KEY` ein und führe dann aus:
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'
```
Dies ist ein Beispiel für die macOS-/Linux-Shell; unter Windows kannst du direkt die [plattformübergreifenden Python-/Node.js-Beispiele](/de/docs/code-examples/) ausführen. Der Text steht in `choices[0].message.content`; wenn das Modell nicht in deiner Liste ist, frage zuerst die [verfügbaren Modelle ab](/de/docs/api-models/). Codex benötigt Responses; integriere ihn gemäß dem [Codex-Konfigurationsleitfaden](/de/docs/quickstart-codex/).
## Nächste Schritte
Integriere es in deine gängigen Tools:
Zwei Umgebungsvariablen genügen.
Verwende es, wenn du die Konfigurationsdatei nicht manuell bearbeiten möchtest.
Schreibweise und Einschränkungen für eine eigene Base URL.
Wenn du bereits OpenAI-Code hast, ändere nur base_url.
Wenn die Anfrage fehlschlägt, siehe zuerst [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/). Um die zurückgegebenen Felder und die Nutzung zu prüfen, siehe [Modell und Nutzung abgleichen](/de/docs/verify-model/).
---
# API-Schlüssel abrufen und verwalten
Source: https://1zheai.com/de/docs/api-keys/
Markdown: https://1zheai.com/de/docs/api-keys.md
---
title: "API-Schlüssel abrufen und verwalten"
description: "Erstellung von API-Schlüsseln, die mit sk- beginnen, im 1zheai-Console, sowie deren Speicherung, Rotation und Schadensbegrenzung bei einem Leak."
headingIds: {"API-Schlüssel erstellen":"section-1","Ein API-Schlüssel pro Werkzeug":"section-2","Wo ablegen":"section-3","Was tun bei einem Leak":"section-4","Häufige Fragen":"section-5"}
---
Ein API-Schlüssel (API key) entspricht einem Aufrufrecht und belastet das Guthaben deines Kontos. Diese Seite erklärt, wie du einen erstellst, wo du ihn ablegst und was zu tun ist, wenn etwas schiefgeht.
## API-Schlüssel erstellen
Öffne [1zheai.com/console](https://1zheai.com/console?lng=de).
Klicke im linken Menü auf „API-Schlüssel“ und dann oben rechts auf „API-Schlüssel erstellen“. Gib einen Namen ein, der den Zweck erkennen lässt, z. B. `claude-code-macbook`, `ci-staging`. Die übrigen Felder können unverändert bleiben; klicke auf „Änderungen speichern“.
Felder im Formular:
| Formularfeld | Standard | Beschreibung |
|---|---|---|
| Name | leer | Unterscheidet den API-Schlüssel im Aufrufprotokoll anhand dieses Namens |
| Ablaufdatum | läuft nie ab | Optional 1 Stunde, 1 Tag, 1 Monat oder ein bestimmtes Datum und eine bestimmte Uhrzeit |
| Anzahl | 1 | Erstellt mehrere auf einmal; den Namen wird automatisch ein zufälliges Suffix hinzugefügt |
| Schalter „Unbegrenztes Kontingent“ | ein | Nach dem Deaktivieren erscheint „Kontingent (USD)“; dieser API-Schlüssel kann höchstens so viele USD ausgeben |
| Modellbeschränkung (unter „Erweiterte Einstellungen“) | leer, d. h. alle Modelle sind erlaubt | Nach Auswahl von Modellen kann dieser API-Schlüssel nur diese Modelle aufrufen |
| IP-Whitelist (unter „Erweiterte Einstellungen“) | leer, d. h. keine Einschränkung | Erlaubt nur Aufrufe von den aufgeführten IPs oder CIDR-Netzbereichen |
API-Schlüssel beginnen mit `sk-`. Kopiere ihn in einen Passwortmanager oder eine Umgebungsvariable und füge ihn nicht in Chats, Screenshots oder Code-Repositories ein.
## Ein API-Schlüssel pro Werkzeug
Es wird empfohlen, für jedes Werkzeug und jeden Rechner einen eigenen API-Schlüssel zu erstellen. Drei Vorteile:
- Das Aufrufprotokoll unterscheidet nach API-Schlüssel; auf einen Blick ist sichtbar, welches Werkzeug wie viel ausgegeben hat.
- Wenn ein API-Schlüssel kompromittiert wird, wird nur dieser gelöscht; die anderen Werkzeuge sind nicht betroffen.
- Im Team ist jeder für seinen eigenen API-Schlüssel verantwortlich; beim Verlassen des Teams oder beim Rechnerwechsel wird der entsprechende API-Schlüssel gelöscht.
## Wo ablegen
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
Das projektbezogene `.claude/settings.json` von Claude Code wird üblicherweise ins Repository eingecheckt; die offizielle Claude-Code-Dokumentation rät ausdrücklich davon ab, Zugangsdaten dort abzulegen. Lege den API-Schlüssel im benutzerbezogenen `~/.claude/settings.json` ab oder in einem im Projekt nicht eingecheckten `.claude/settings.local.json`.
## Was tun bei einem Leak
1. Suche ihn in der Liste „API-Schlüssel“, klicke auf das Symbol „Deaktivieren“ in der Spalte „Aktionen“ oder wähle im Menü „⋯“ die Option „Löschen“. Nach der Deaktivierung ist er sofort ungültig; weitere Aufrufe damit geben 401 `Invalid token` zurück.
2. Erstelle einen neuen API-Schlüssel und ersetze ihn an den Stellen, an denen er verwendet wird.
3. Öffne das Aufrufprotokoll (Menü „Aufrufprotokoll“ in der Konsole), klicke auf „Ausklappen“ und filtere im Feld „Token-Name“ nach dem Namen dieses API-Schlüssels, um zu prüfen, ob in den letzten Aufrufen welche vorkommen, die nicht von dir stammen.
## Häufige Fragen
Ja, ein API-Schlüssel ist nicht an ein Werkzeug gebunden. Wenn er jedoch gemischt wird, lässt sich im Protokoll nicht erkennen, wer ausgegeben hat; deshalb wird empfohlen, getrennte Schlüssel zu erstellen.
Meistens ja. Häufige Ursachen: beim Kopieren mitgeführte Leerzeichen oder Zeilenumbrüche, gelöschter API-Schlüssel, Eingabe in das falsche Feld des Werkzeugs. Die schrittweise Fehlersuche findest du unter[Fehlercodes und Fehlersuche](/de/docs/troubleshooting/).
Standardmäßig läuft er nie ab. Beim Erstellen oder Bearbeiten kannst du unter „Ablaufdatum“ eine Zeit festlegen; nach Ablauf geben weitere Aufrufe 401 `Invalid token` zurück, gleich wie die Antwort bei einem falsch eingegebenen API-Schlüssel. Die Spalte „Ablauf“ in der Liste zeigt das Ablaufdatum jedes API-Schlüssels.
---
# Unterstützte Modelle
Source: https://1zheai.com/de/docs/models/
Markdown: https://1zheai.com/de/docs/models.md
---
title: "Unterstützte Modelle"
description: "Verfügbarkeit, Modell-IDs, Schnittstellen und Preise für Claude, GPT, MiMo und Bildgenerierungsmodelle abfragen."
headingIds: {"Modellliste":"section-1","Beide Schnittstellen nutzbar":"section-2","OpenAI-/GPT-Modelle":"section-3","MiMo-Modelle":"section-4","Aktuelle Liste über die Schnittstelle abfragen":"section-5","Auswahl":"section-6","Häufige Fragen":"section-7","Bildmodelle und Abfrage über die Schnittstelle":"section-8"}
---
Claude-, GPT-, MiMo- und Bildgenerierungsmodelle sind verfügbar. Nachfolgend sind die Modell-IDs für Claude und GPT aufgeführt; die vollständige Verfügbarkeit ergibt sich aus dem Modellkatalog und der Antwort der Schnittstelle.
Siehe [öffentliche Modelle und Preise](https://1zheai.com/en/pricing/) für die Preisgestaltung; angemeldete Benutzer können im [Konsole · Modelle](https://1zheai.com/model-catalog) nach Modellen suchen und die Zugriffsweise einsehen.
## Modellliste
Das `model` in der Anfrage muss exakt mit der ID in der folgenden Tabelle übereinstimmen, einschließlich des Datumsuffixes.
| Modell-ID | Serie | Beschreibung |
|---|---|---|
| `claude-fable-5-1` | Fable 5.1 | |
| `claude-fable-5` | Fable 5 | |
| `claude-opus-5-5` | Opus 5.5 | |
| `claude-opus-5` | Opus 5 | |
| `claude-opus-4-8` | Opus 4.8 | |
| `claude-opus-4-7` | Opus 4.7 | |
| `claude-opus-4-6` | Opus 4.6 | |
| `claude-opus-4-5-20251101` | Opus 4.5 | Festgelegte Versions-ID mit Datum |
| `claude-sonnet-5-5` | Sonnet 5.5 | |
| `claude-sonnet-5` | Sonnet 5 | |
| `claude-sonnet-4-6` | Sonnet 4.6 | |
| `claude-sonnet-4-5-20250929` | Sonnet 4.5 | Festgelegte Versions-ID mit Datum |
| `claude-haiku-5-5` | Haiku 5.5 | |
| `claude-haiku-4-5-20251001` | Haiku 4.5 | Festgelegte Versions-ID mit Datum |
Die Einzelpreise für jedes Modell (Eingabe, Ausgabe, Cache-Lesezugriff, Cache-Schreibzugriff) finden Sie auf der [Preisseite](https://1zheai.com/en/pricing/). Fähigkeiten, Kontextlänge und Veröffentlichungshinweise der Modelle ergeben sich aus den [offiziellen Anthropic-Modellunterlagen](https://platform.claude.com/docs/en/about-claude/models/overview).
## Beide Schnittstellen nutzbar
Alle Modelle in der obigen Tabelle können sowohl über die native Anthropic-Schnittstelle `/v1/messages` als auch über die OpenAI-kompatible Schnittstelle `/v1/chat/completions` aufgerufen werden; die Schreibweise der Modell-ID ist identisch. Für Claude-spezifische Parameter wie Caching, Thinking oder Tool-Aufrufe verwenden Sie die native Schnittstelle, siehe [Base URL und Authentifizierung](/de/docs/base-url/).
## OpenAI-/GPT-Modelle
- `gpt-5.6-luna`
- `gpt-5.6-sol`
- `gpt-5.6-terra`
- `gpt-6-astra`
GPT kann mit dem [OpenAI SDK](/de/docs/quickstart-openai-sdk/) und der [Codex CLI](/de/docs/quickstart-codex/) verwendet werden. Schnittstelle und Abrechnungsweise je Modell ergeben sich aus dem [Modellkatalog der Konsole](https://1zheai.com/model-catalog).
## MiMo-Modelle
IDs, unterstützte Schnittstellen und Abrechnungseinheiten der MiMo- Text- und Sprachmodelle finden Sie unter [Modelle und Preise](https://1zheai.com/en/pricing/). Text wird pro Token, Sprache nach der Abrechnungseinheit des jeweiligen Modells abgerechnet; wenden Sie die Cache- und Rabattregeln von Claude nicht an.
## Aktuelle Liste über die Schnittstelle abfragen
Modelle werden je nach offizieller Veröffentlichung hinzugefügt oder entfernt; maßgeblich ist die Antwort der Schnittstelle:
```bash title="用你的 Key 查"
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-你的Key"
```
```bash title="公开价格接口（不需要 Key）"
curl -s https://1zheai.com/api/pricing | jq -r '.data[].model_name'
```
## Auswahl
Wenn Sie nicht wissen, welches Modell Sie wählen sollen, können Sie so starten:
| Szenario | Empfehlung |
|---|---|
| Tägliche Codearbeit, Hauptmodell für Claude Code | `claude-sonnet-5-5` |
| Komplexe Refactorings, schwer zu diagnostizierende Probleme | `claude-opus-5-5` |
| Unteraufgaben, Zusammenfassungen, Klassifizierung und andere leichte Aufgaben | `claude-haiku-5-5` |
Wie Sie in Claude Code die drei Stufen opus / sonnet / haiku auf konkrete Modelle abbilden, siehe [Claude-Code-Anbindung](/de/docs/quickstart-claude-code/).
## Häufige Fragen
Prüfen Sie zuerst die Schreibweise der ID und das Datumsuffix und bestätigen Sie anschließend mit dem oben genannten `/v1/models`, dass Ihr API-Schlüssel (API key) dieses Modell sehen kann. Eigene Modellnamen anderer Anbieter (z. B. mit Präfix oder Suffix) sind hier nicht verwendbar.
Ist das Modell nicht vorhanden oder derzeit nicht verfügbar, gibt das Gateway HTTP 404 zurück. In der nativen Anthropic-Antwort lautet `error.type` `not_found_error`; in der OpenAI-kompatiblen Antwort lautet `error.code` `model_not_found`.
Prüfen Sie zuerst die ID und die Liste der verfügbaren Modelle Ihres Schlüssels und wiederholen Sie nicht wiederholt dieselbe fehlerhafte ID. Eine 503 wird nur zurückgegeben, wenn das Modell existiert, aber derzeit kein gesunder Upstream-Dienst verfügbar ist, siehe [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/).
Im Normalfall entspricht die `model` in der Antwort der angeforderten ID. Stimmt sie nicht überein, senden Sie Anfragezeitpunkt und Antwort an support@1zheai.com; Sie können auch die Prüfung unter [Modell und Verbrauch abgleichen](/de/docs/verify-model/) durchführen.
## Bildmodelle und Abfrage über die Schnittstelle
Der öffentliche Katalog listet am 2026-10-16 `gpt-image-1.5` und `chatgpt-image-latest`. Details siehe [Bildgenerierung anbinden](/de/docs/api-images/); tatsächliche Berechtigungen und Parameter ergeben sich aus Ihrem Schlüssel und dem Modellkatalog.
Vollständige Beispiele der Modell-API, beide Antwortformate und die Fehlerbehebung bei leerer Liste finden Sie unter [Verfügbare Modelle über die API abfragen](/de/docs/api-models/).
---
# Migration von anderen Diensten zu 1折AI
Source: https://1zheai.com/de/docs/migration/
Markdown: https://1zheai.com/de/docs/migration.md
---
title: "Migration von anderen Diensten zu 1折AI"
description: "Migration Schritt für Schritt nach Adresse, Schlüssel, Modell, Protokoll und Funktionen, mit erhalten bleibender, rücksetzbarer Originalkonfiguration."
headingIds: {"Vier Konfigurationen gemeinsam prüfen":"section-1","Der Reihe nach verifizieren":"section-2","Geltungsbereich von Umgebungsvariablen":"section-3","Rückfall bei fehlgeschaltetem Umstellen":"section-4"}
---
Vor der Migration die Originalkonfiguration speichern. Zuerst in einem separaten Terminal oder einer Entwicklungsumgebung verifizieren und erst nach erfolgreicher Bestätigung gängige Tools oder produktive Dienste ändern.
## Vier Konfigurationen gemeinsam prüfen
| Konfiguration | Schreibweise bei 1折AI | Häufige Fehler |
| --- | --- | --- |
| OpenAI Base URL | `https://1zheai.com/v1` | `/chat/completions` zu oft hinzugefügt oder `/v1` vergessen |
| Anthropic Base URL | `https://1zheai.com` | SDK fügt `/v1` ein zweites Mal an |
| API-Schlüssel | Auf dieser Website im Konsole erstellter Schlüssel | Alter Schlüssel des vorherigen Anbieters weiterverwenden |
| Modell-ID | Vollständige ID, die von `/v1/models` auf dieser Website zurückgegeben wird | Namen mit `vendor/`-Präfix oder benutzerdefiniertem Suffix weiterverwenden |
Ursprüngliche HTTP-Anfragen benötigen den vollständigen Endpunkt-Pfad; SDKs und Desktop-Tools verlangen in der Regel nur die Base URL. Maßgeblich ist die [entsprechende Tool-Anleitung](/de/docs/integrations/).
## Der Reihe nach verifizieren
Einmal gemäß der [Modell-Abfrage-Schnittstelle](/de/docs/api-models/) aufrufen. Bei Fehlern zuerst Adresse, Zugangsdaten oder Zugriffsbedingungen korrigieren, nicht gleichzeitig mehrere Geschäftsparameter anpassen.
[Chat Completions](/de/docs/api-chat-completions/), [Responses](/de/docs/api-responses/) oder [Messages](/de/docs/api-messages/) auswählen. Das vom ursprünglichen Client benötigte Protokoll beibehalten, optionale Parameter zuerst entfernen.
Nacheinander Streaming, mehrstufigen Verlauf, Tool-Aufrufe und die weiteren benötigten Fähigkeiten verifizieren. Bei jedem Schritt nur eine Funktion hinzufügen und vergleichbare Fehlerantworten aufbewahren. Erfolg bei normalem Text bedeutet nicht, dass Dateien, Suche und Hilfsmodelle des Agent vollständig kompatibel sind.
In den [Aufruf-Protokollen](/de/docs/usage-logs/) Zeitpunkt und Modell der Anfrage bestätigen. Terminale, IDEs oder Hintergrunddienste, die eine Neuladung der Konfiguration erfordern, neu starten, damit sie nicht weiterhin alte Umgebungsvariablen verwenden.
## Geltungsbereich von Umgebungsvariablen
`export` im Terminal wirkt nur auf die aktuelle Shell und danach gestartete Kindprozesse. Desktop-Anwendungen, Container, geplante Aufgaben und Systemdienste können eine andere Umgebung verwenden; Zugangsdaten dort konfigurieren, wo das Programm tatsächlich ausgeführt wird.
Felder gleichen Namens in Konfigurationsdateien können Umgebungsvariablen ebenfalls überschreiben. Tools wie Claude Code und Codex verweisen jeweils auf ihre eigenen Anleitungen; nicht alle Anbieter-Variablen gleichzeitig in die globale Shell-Konfiguration stapeln.
## Rückfall bei fehlgeschaltetem Umstellen
Zuvor gespeicherte Anbieter-, Adress- und Modellkonfiguration wiederherstellen und den Client neu starten. Wenn produktive Dienste migriert werden, zuerst mit wenigen Anfragen verifizieren und dann den Umfang erweitern; die Konfigurations-Umschaltung auf Anwendungsebene beibehalten, um den Dienst wiederherstellen zu können.
Bei unklarer Funktionsverfügbarkeit im Modellkatalog nachschauen oder den Support kontaktieren. Nicht annehmen, dass diese Website dieselben Dienste anbietet, nur weil andere Plattformen Embeddings, Batch oder ein bestimmtes proprietäres Bildmodell bereitstellen.
---
# Häufige Fragen zur API-Anbindung
Source: https://1zheai.com/de/docs/faq/
Markdown: https://1zheai.com/de/docs/faq.md
---
title: "Häufige Fragen zur API-Anbindung"
description: "Schnelle Übersicht über häufige Fragen zu Base URL, Modellen, Streaming, Clients, Timeouts und Verfügbarkeitsüberwachung."
headingIds: {"Adresse, Schlüssel und Modelle":"section-1","Anfragen und Clients":"section-2","Service-Status und Hilfe":"section-3"}
---
## Adresse, Schlüssel und Modelle
Im OpenAI SDK `https://1zheai.com/v1` eintragen; im Anthropic SDK und in Claude Code `https://1zheai.com` eintragen. Bei direkter Verwendung von curl den vollständigen Anfragepfad angeben. Einige Desktop-Tools ergänzen den Pfad automatisch, siehe [Adressübersichtstabelle ](/de/docs/base-url/).
Ja. Für die Anbindung an diese Website wird ein in der Konsole dieser Website erstellter API-Schlüssel verwendet; die Abonnements von Verbraucher-Clients sind ein anderer Zugangsweg als die API-Zugangsdaten dieser Website. Das Tool muss außerdem einen benutzerdefinierten Anbieter- oder API-Adresse unterstützen.
Die Liste zeigt die Modelle, die für den aktuellen Schlüssel sichtbar sind, nicht die Echtzeit-Inferenz-Erfolgsquote. Prüfen Sie zusätzlich das Schnittstellenprotokoll, die optionalen Parameter und den Upstream-Status, siehe [Modell-Abfrage-API ](/de/docs/api-models/).
Die vollständige ID aus der Modellliste dieser Website kopieren. Verschiedene Anbieter verwenden möglicherweise unterschiedliche Präfixe, Aliase und Datumsversionen; raten Sie keine umbenannten Modelle. Migrationsanleitung siehe [Migrationsleitfaden ](/de/docs/migration/).
## Anfragen und Clients
Zuerst das Antwortprotokoll bestätigen. Chat Completions liest `choices[].message.content`, Messages iteriert über `content`-Textblöcke, Responses iteriert über `output` oder verwendet das `output_text` des SDK. Tool-Call-Antworten enthalten möglicherweise ebenfalls keinen normalen Text.
Mehrstufige Dialoge erfordern, dass der Client die Historie übermittelt. Wiederholte Verwendung desselben Schlüssels erstellt nicht automatisch eine serverseitige Sitzung. Sitzungsbezogene Erweiterungen von Responses müssen separat auf Unterstützung geprüft werden; verlassen Sie sich nicht standardmäßig darauf.
Zusätzlich müssen das Endereignis oder der Endzustand bestätigt werden. Fehler in der Mitte, unterbrochene Streams und abgeschnittene Ausgaben können auftreten, nachdem bereits teilweise Text empfangen wurde. Details siehe [Streaming-Ausgabe ](/de/docs/streaming/).
Nicht empfohlen. Timeouts können auftreten, nachdem die Anfrage bereits verarbeitet wurde. Prüfen Sie zuerst die Aufrufprotokolle und führen Sie dann Wiederholungen mit begrenzter Anzahl, Backoff und Gesamtwartezeit durch, um zu vermeiden, dass SDK und Anwendung jeweils eine Wiederholungsrunde ausführen. Siehe [Timeouts und Wiederholungen ](/de/docs/retries/).
Kompilieren Sie den Schlüssel nicht in Browser-Skripte oder öffentliche Repositories. Lassen Sie Ihren Server die Zugangsdaten halten und die API aufrufen; der Browser verbindet sich nur mit Ihrem eigenen Backend. Umgebungsvariablen in Beispielcode dienen dem Server oder dem lokalen Terminal.
## Service-Status und Hilfe
Die Überwachung prüft die HTTP-Erreichbarkeit der Website, der Konsole und des API-Eingangs und stellt nicht die Inferenz-Erfolgsquote jedes einzelnen Modells dar. Die Überwachung läuft auf demselben Server wie die Anwendung; bei einem Gesamtausfall des Servers wird auch die Überwachung pausiert; historische Daten werden ab der Aktivierung kumuliert.
Geben Sie Zeitpunkt und Zeitzone, Client-Version, Modell-ID, vollständigen Anfragepfad, HTTP-Statuscode, Anfrage-ID und die bereinigte Fehlermeldung an. Entfernen Sie Schlüssel, Authentifizierungs-Header und private Gesprächsinhalte; Sie können die [Fehleranalysevorlage ](/de/docs/troubleshooting/) verwenden.
---
# Kaufanleitung für den Shop
Source: https://1zheai.com/de/docs/store-guide/
Markdown: https://1zheai.com/de/docs/store-guide.md
---
title: "Kaufanleitung für den Shop"
description: "Erfahren Sie den Unterschied zwischen einsatzbereiten Konten, Abo-Aufladungen und Geschenkkarten, bestellen Sie gemäß den Produktvorgaben und verfolgen Sie die Lieferung."
headingIds: {"Vor der Bestellung prüfen":"section-1","Bestellung und Lieferung":"section-2","Vor dem Kauf zwingend zu wissen":"section-3","Freunde zum Kauf einladen":"section-4"}
---
Wählen Sie im Shop ein KI-Konto, einen Abonnementdienst oder eine Geschenkkarte. Lesen Sie vor der Bestellung die Produktbeschreibung.
| Was Sie brauchen | Zu wählender Dienst | Wo Sie nachsehen können |
| --- | --- | --- |
| Modelle in Code oder Tools aufrufen | Modell-API | [API-Schnellstart](/de/docs/quickstart/) |
| Ein bestehendes Drittplattform-Konto kaufen | Fertiges Konto | [Kauf und Verwendung fertiger Konten](/de/docs/account-guide/) |
| Für Ihr eigenes Drittplattform-Konto eine Mitgliedschaft aktivieren | Abo-Aufladung | [Bedingungen und Ablauf der Aufladung](/de/docs/subscription-guide/) |
| Ein Einlösecode oder Einlöselink erhalten | Geschenkkarte | [Hinweise zu Einlösung und Verwendung](/de/docs/gift-card-guide/) |
Die API-Schlüssel dieser Website können nicht zum Anmelden bei ChatGPT, Claude oder Grok verwendet werden; der Kauf einer Mitgliedschaft auf einer Drittplattform entspricht auch nicht einer Aufladung des API-Guthabens dieser Website.
## Vor der Bestellung prüfen
Sehen Sie sich Produktname, Spezifikation, Region, Abo-Dauer, aktuellen Bestand, Lieferart und Kaufhinweise an. Spezifikationen, die im Katalog nicht angezeigt werden oder nicht kaufbar sind, sind noch nicht freigeschaltet. Zahlen Sie nicht nach dem Ablauf auf einer Demo-Seite oder nach dem Verfahren anderer Anbieter.
Ob ein Produkt Verlängerung, Änderung der E-Mail-Adresse, Nutzung durch mehrere Personen oder einen bestimmten Client unterstützt, richtet sich ausschließlich nach der Beschreibung des gewählten Produkts. Ist nichts ausdrücklich angegeben, kontaktieren Sie zuerst den Support zur Bestätigung; diese Fähigkeiten sind nicht automatisch enthalten.
## Bestellung und Lieferung
1. Wählen Sie im[Online-Shop](https://1zheai.com/en/store/)Produkt und Spezifikation aus.
2. Nach dem Anmelden prüfen Sie Abrechnungspreis, Menge und Kaufhinweise. Für Aufladungsprodukte müssen zusätzlich die im Formular erforderlichen Angaben eingetragen werden.
3. Lesen Sie die Risiko- und After-Sales-Regeln, bestätigen Sie diese aktiv per Häkchen und geben Sie dann die Bestellung auf; die Bestellung wird mit dem Wallet-Guthaben dieser Website bezahlt.
4. Sehen Sie in[Meine Bestellungen](https://1zheai.com/store-orders?lng=de)Status, Lieferinhalt oder erforderliche Zusatzangaben nach. Ein erfolgreich aufgeladenes Guthaben bedeutet nicht, dass das Produkt gekauft oder die Aufladung abgeschlossen wurde.
Automatisch gelieferte Produkte mit Bestand, manuell gelieferte Produkte und nach der Bestellung aktivierte Aufladungen werden unterschiedlich bearbeitet. Es wird nicht pauschal Sofortlieferung oder ein fester Fertigstellungszeitraum zugesichert; maßgeblich sind die Abrechnungsseite und die Bestellansicht.
## Vor dem Kauf zwingend zu wissen
Wird ein fertiges Konto regulär geliefert oder die Aufladung erfolgreich abgeschlossen und das Konto anschließend von der Drittplattform gesperrt, erfolgt keine Rückerstattung wegen der Sperrung. Wir können bei der Einsprache unterstützen, versprechen aber kein Ergebnis der Entsperung. Bei Nichtlieferung wie vereinbart, erfolgloser Aufladung oder Fällen, in denen die gesetzliche Haftung bei dieser Website liegt, gelten die entsprechenden After-Sales-Regeln.
[Geschäfts- und After-Sales-Regeln](/de/docs/store-rules/) · [Fehlerbehebung bei Bestellungsproblemen](/de/docs/store-orders/)
## Freunde zum Kauf einladen
Shop-Produkte können je nach Spezifikation an der Provision teilnehmen. Umfang, Zuordnung und Abrechnungsbedingungen siehe[Einladungsprämien und Shop-Provision](/de/docs/affiliate-guide/).
---
# Kauf und Nutzung von fertigen Accounts
Source: https://1zheai.com/de/docs/account-guide/
Markdown: https://1zheai.com/de/docs/account-guide.md
---
title: "Kauf und Nutzung von fertigen Accounts"
description: "Spezifikationen, Lieferumfang, Erstanmeldung und Bann-Risiken, die vor dem Kauf fertiger ChatGPT-, Claude- und Grok-Accounts zu prüfen sind."
headingIds: {"Vor dem Kauf prüfen":"section-1","Nach Erhalt des Accounts":"section-2","Tägliche Nutzung und Erneuerung":"section-3","Banns und After-Sales-Service":"section-4"}
---
Ein fertiger Account liefert ein Konto auf einer Drittanbieter-Plattform, so wie es in der ausgewählten Produktbeschreibung angegeben ist. Ob ein Abonnement enthalten ist, die Abonnement-Stufe und die verbleibende Laufzeit richten sich jeweils nach diesem Produkt und der Bestellung; beurteilen Sie dies nicht allein anhand des Plattformnamens.
## Vor dem Kauf prüfen
- Ob ein Abonnement enthalten ist und welche konkrete Stufe (z. B. Pro, Max) sowie welche Laufzeit gilt; nicht angezeigte Spezifikationen sind nicht käuflich erwerbbar.
- Region, Anmeldemethode und Lieferumfang; ob Zugriff auf die E-Mail, Empfang von Bestätigungscodes oder die Möglichkeit zur Änderung der E-Mail-Adresse bereitgestellt wird.
- Ob es sich um eine einmalige Lieferung handelt oder separate Erneuerungsregelungen bestehen; nehmen Sie nicht an, dass automatische Verlängerung, E-Mail-Weiterleitung oder Erneuerungserinnerungen enthalten sind.
- Ob Team-, gemeinsame oder übertragene Nutzung gestattet ist, sowie die eigenen Nutzungsbedingungen und regionalen Einschränkungen der Drittanbieter-Plattform.
## Nach Erhalt des Accounts
1. Prüfen Sie in [Meine Bestellungen ](https://1zheai.com/store-orders?lng=de) Produkt, Spezifikationen und Lieferinformationen und bewahren Sie die Bestellnummer sicher auf.
2. Melden Sie sich gemäß den Anmeldeanweisungen dieses Produkts auf der entsprechenden Plattform an und prüfen Sie, ob sich der Account anmelden lässt, welche Abonnement-Stufe gilt und wie lange die Gültigkeit dauert.
3. Ändern Sie das Passwort, die Wiederherstellungsinformationen oder aktivieren Sie die Sicherheitsüberprüfung auf die vom Produkt erlaubte Weise; bei Elementen, die nicht geändert werden können, wenden Sie sich zuerst an den Support zur Bestätigung.
4. Wenn die gelieferten Informationen ungültig sind, die Spezifikationen nicht übereinstimmen oder die Anmeldung fehlschlägt, bewahren Sie geschwärzte Screenshots und Fehlermeldungen auf und schildern Sie den Sachverhalt über den Supportkanal der offiziellen Website. Teilen Sie Account-Passwörter, Bestätigungscodes oder Wiederherstellungscodes nicht öffentlich mit.
## Tägliche Nutzung und Erneuerung
Halten Sie sich an die Nutzungsbedingungen der Plattform. Der Account kann regionalen Einschränkungen, Nutzungsbeschränkungen, Identitätsprüfungen oder risikobezogenen Kontrollen unterliegen; der Kauf beinhaltet keine Garantie dafür, Einschränkungen zu umgehen, Identitätsprüfungen für Sie durchzuführen oder niemals gebannt zu werden. Die Identitätsprüfung muss vom tatsächlichen Nutzer gemäß den Anforderungen der Plattform abgeschlossen werden; senden Sie keine Ausweisdokumente oder Bestätigungscodes an den Kundenservice, es sei denn, es gibt einen anderen ausdrücklichen und notwendigen legitimen Vorgang.
Wenn eine Erneuerung erforderlich ist, bestätigen Sie zuerst die vom aktuellen Produkt unterstützte Methode; wenden Sie Aufladungen, die für Ihr eigenes Konto bestimmt sind, nicht direkt auf einen fertigen Account an und stapeln Sie keine unvereinbaren Abonnements eigenständig aufeinander.
## Banns und After-Sales-Service
Nachdem ein fertiger Account normal geliefert wurde oder eine Aufladung erfolgreich war, wird bei einem Bann des Accounts durch die Drittanbieter-Plattform aufgrund des Bans keine Rückerstattung gewährt. Wir können bei einem Einspruch helfen, versprechen aber kein Ergebnis aufhebenden Bans. Nicht vertragsgemäße Lieferung, eine erfolglose Aufladung oder Fälle, für die diese Website gesetzlich die Verantwortung trägt, werden nach den entsprechenden After-Sales-Regeln behandelt.
[Detailierte Transaktionsregeln ](/de/docs/store-rules/) · [Problembehebung bei Bestellproblemen ](/de/docs/store-orders/)}
---
# Bedingungen und Ablauf der Abo-Aufladung
Source: https://1zheai.com/de/docs/subscription-guide/
Markdown: https://1zheai.com/de/docs/subscription-guide.md
---
title: "Bedingungen und Ablauf der Abo-Aufladung"
description: "Prüfen Sie die Voraussetzungen, die erforderlichen Informationen, die Sicherheitshinweise und die Auftragsabwicklung, bevor Sie mit Ihrem eigenen Konto aufladen."
headingIds: {"Zuerst die Kontobedingungen prüfen":"section-1","Bestellablauf":"section-2","Informationssicherheit":"section-3","Verarbeitung, Fehlschlag und Rückerstattungen":"section-4"}
---
Die Abo-Aufladung aktiviert die ausgewählte Mitgliedschaft für Ihr bestehendes Konto auf einer Drittanbieter-Plattform; es wird kein neues Konto übergeben. Ob ein Produkt zum Verkauf angeboten wird und welche Plattformen und Stufen unterstützt werden, richtet sich nach dem, was der [Store](https://1zheai.com/en/store/) derzeit anzeigt. Dieses Dokument bedeutet nicht, dass alle Plattformen oder Spezifikationen geöffnet sind.
## Zuerst die Kontobedingungen prüfen
Prüfen Sie die Region, den Kontotyp, den aktuellen Abo-Status, den offenen Saldo, die Rückerstattungshistorie und die Verlängerungsbeschränkungen, die das ausgewählte Produkt erfordert. Die Bedingungen können je nach Kanal variieren; wir verlangen nicht einheitlich, dass alle Konten Free sind, und wir garantieren auch nicht einheitlich, dass ein Stapeln, ein Upgrade oder die Verlängerung eines bestehenden Abos möglich ist.
Wenn Sie bereits ein Abo haben, einen offenen Saldo, Plattformbeschränkungen oder sich unsicher über die Kontoeignung sind, kontaktieren Sie zuerst den Support. Platzieren Sie keine wiederholten Bestellungen zum Testen und ersetzen Sie die Produkthinweise dieser Website nicht durch Anleitungen anderer Händler.
## Bestellablauf
1. Wählen Sie die konkrete Spezifikation und bestätigen Sie Preis, Laufzeit, anwendbares Konto und Aktivierungsmethode.
2. Füllen Sie die von dieser Spezifikation erforderten Informationen im Bestellformular auf dieser Website aus, z. B. die Kontokennung oder die Organization ID; die Felder variieren je nach Produkt.
3. Überprüfen Sie das Zielkonto und die Informationen, lesen Sie den Risikohinweis und senden Sie die Bestellung ab.
4. Prüfen Sie den Verarbeitungsfortschritt unter [Meine Bestellungen](https://1zheai.com/store-orders?lng=de). Aktualisieren Sie Informationen nur, wenn die ursprüngliche Bestellung angibt, dass sie korrigiert werden kann; kaufen Sie nicht erneut.
5. Nachdem die Bestellung als abgeschlossen angezeigt wird, melden Sie sich bei der Drittanbieter-Plattform an, um die Mitgliedschaftsstufe und den Gültigkeitszeitraum zu prüfen; wenn weiterhin anzeigt wird, dass nichts aktualisiert wurde, aktualisieren Sie oder melden Sie sich erneut an und prüfen Sie es noch einmal, und kontaktieren Sie den Support, wenn es weiterhin nicht übereinstimmt.
## Informationssicherheit
Einige Spezifikationen können Anmelde-Sitzungsinformationen wie Session JSON erfordern. Diese Art von Informationen kann den Zugriff auf Ihr Konto ermöglichen und ist ebenso sensibel wie ein Passwort. Senden Sie sie nur über das dafür vorgesehene Formular für den entsprechenden Bestellung auf dieser Website; senden Sie sie nicht an den Online-Chat, E-Mail, öffentliche Screenshots oder Drittanbieter-Kontoabfrage-Websites. Senden Sie sie erst ab, nachdem Sie den Umfang der Autorisierung verstanden haben und die Produktanforderungen akzeptiert haben; wenn Sie sie nicht akzeptieren können, kaufen Sie diese Spezifikation nicht.
Senden Sie keine Passwörter, Verifizierungscodes, API-Schlüssel oder vollständigen Anmelde-Sitzungen in gewöhnlichen Kundenservice-Nachrichten. Nach Abschluss der Verarbeitung prüfen und verwalten Sie die Anmeldegeräte und Sitzungen mit den von der Drittanbieter-Plattform bereitgestellten Methoden.
## Verarbeitung, Fehlschlag und Rückerstattungen
Die Verarbeitung beginnt nach der Zahlung; sobald sie sich im Verarbeitungsstadium befindet, kann sie nicht direkt storniert werden. Eine Zeitüberschreitungs- oder Fehlschlagmeldung bedeutet keine Rückerstattung und bedeutet auch nicht unbedingt, dass die Aktivierung nicht stattgefunden hat. Bewahren Sie die ursprüngliche Bestellung auf, warten Sie, bis der Status aktualisiert wird, oder kontaktieren Sie den Support zur Überprüfung, und vermeiden Sie doppelte Gebühren oder doppelte Aktivierung. Rückerstattungsergebnisse und -ziele richten sich nach den Bestell- und Wallet-Aufzeichnungen auf dieser Website; wir versprechen nicht, dass Rückerstattungen immer über die ursprüngliche Zahlungsmethode zurückgezahlt werden.
Nachdem ein fertiges Konto normal übergeben wurde oder eine Aufladung erfolgreich war, wird keine Rückerstattung aufgrund einer Sperre durch die Drittanbieter-Plattform gewährt, wenn das Konto gesperrt wird. Wir können bei Einsprüchen helfen, versprechen aber kein Ergebnis für die Entsperre. Nichterfüllung der vereinbarten Lieferung, erfolglose Aufladung oder Situationen, für die diese Website nach dem Gesetz die Verantwortung tragen muss, werden entsprechend den jeweiligen After-Sales-Regeln behandelt.
[Transaktions- und After-Sales-Regeln](/de/docs/store-rules/) · [Fehlerbehebung bei Bestellproblemen](/de/docs/store-orders/)
---
# Hinweise zur Einlösung von Geschenkkarten
Source: https://1zheai.com/de/docs/gift-card-guide/
Markdown: https://1zheai.com/de/docs/gift-card-guide.md
---
title: "Hinweise zur Einlösung von Geschenkkarten"
description: "Vor Kauf und Einlösung Region, Gültigkeitsdauer, gültige Konten und Regeln zur Auslieferung von Karten-Codes prüfen."
headingIds: {"Vor dem Kauf bestätigen":"section-1","Verwendung nach Erhalt":"section-2","Stornierung und After-Sales":"section-3"}
---
Geschenkkarten werden als Einlösecode oder Einlöselink geliefert; Abonnement-Aufladungen können dagegen direkt im Bestellvorgang aktiviert werden. Beides ist nicht dieselbe Art der Lieferung – nicht jede Aufladung bedeutet, dass man einen Karten-Code erhält und dann auf einer externen Seite einlöst.
## Vor dem Kauf bestätigen
Prüfen Sie die im Produkt angegebene Plattform, Region, Währung oder den Nennwert, die Abonnement-Stufe, die Gültigkeitsdauer und die Bedingungen für verwendbare Konten. Ob bestehende Abonnements, mobile Abonnements, gestapelte Einlösungen oder Verschenken unterstützt werden, ist jeweils in der Produktbeschreibung nachzulesen; behandeln Sie die Gültigkeitsdauer oder Einlösebedingungen anderer Anbieter nicht als Zusage dieser Seite.
Wenn im Shop keine kaufbaren Geschenkkarten verfügbar sind, bedeutet das, dass derzeit kein Kauf möglich ist. Ändern sich Plattformregeln oder der Lieferstatus, gilt die tatsächlich angezeigte Produktinformation.
## Verwendung nach Erhalt
1. Prüfen Sie die Lieferinhalte in[Meine Bestellungen](https://1zheai.com/store-orders?lng=de) und geben Sie Einlösecodes oder Screenshots mit Einlösecodes nicht öffentlich preis.
2. Stellen Sie sicher, dass Sie im richtigen Zielkonto angemeldet sind, und gehen Sie dann gemäß Produktbeschreibung zum angegebenen Einlösebereich; seien Sie vorsichtig bei unbekannten Websites, die zusätzliche Überweisungen oder die Angabe eines Passworts verlangen.
3. Prüfen Sie vor der Einlösung erneut Region und Kontostatus und kontrollieren Sie nach der Einlösung die tatsächlich gutgeschriebenen Rechte.
4. Bei bereits verwendetem, ungültigem Code, falscher Region oder nicht gutgeschriebenen Rechten: Bestellnummer, Fehlerinhalt und geschwärzte Screenshots aufbewahren und den Support kontaktieren; kaufen Sie nicht erneut, um es auszuprobieren.
## Stornierung und After-Sales
Bestellungen, die noch nicht bearbeitet wurden, können über den in der Bestellung angegebenen Eintrag storniert werden; nach Lieferung des Einlösecodes ist eine direkte Rückerstattung nicht möglich. Bei Problemen kontaktieren Sie bitte den Support zur Prüfung. Bei nicht vertragsgemäßer Lieferung, ungültiger Lieferung oder Fällen, für die diese Seite gesetzlich verantwortlich ist, gelten die entsprechenden After-Sales-Regeln. Sperrungen, Einlösebeschränkungen und Rückerstattungsbedingungen der Geschenkkarte richten sich nach den besonderen Hinweisen des jeweiligen Produktes; die Rückerstattungsregeln für API-Guthaben sind nicht anwendbar.
[Geschäfts- und After-Sales-Regeln](/de/docs/store-rules/) · [Fehlerbehebung bei Bestellungsproblemen](/de/docs/store-orders/)
---
# Bestellstatus und Problemlösung
Source: https://1zheai.com/de/docs/store-orders/
Markdown: https://1zheai.com/de/docs/store-orders.md
---
title: "Bestellstatus und Problemlösung"
description: "Lieferinhalte, Bearbeitungsfortschritt, Datenkorrekturen und Rückerstattungsnachweise finden, um Doppelbestellungen zu vermeiden."
headingIds: {"Statusbeschreibung":"section-1","Häufige Fragen":"section-2","Betrag abgebucht, aber Konto oder Mitgliedschaft nicht erhalten":"section-3","Daten falsch eingegeben":"section-4","Bestellung zeigt Abschluss, Plattform hat noch keine Mitgliedschaft":"section-5","Konto gesperrt oder Identitätsprüfung verlangt":"section-6","Wo ist die Rückerstattung?":"section-7","Was muss ich beim Supportkontakt angeben?":"section-8"}
---
Wählen Sie in[Meine Bestellungen](https://1zheai.com/store-orders) die entsprechende Bestellung aus. Kaufnachweis, Lieferinhalte und Bearbeitungsfortschritt richten sich nach dieser Bestellung; Guthabenaufladungen sind keine Warenbestellung.
## Statusbeschreibung
| Status | Bedeutung | Nächster Schritt |
| --- | --- | --- |
| Ausstehende Lieferung | Bestellung wurde erstellt, Lieferung noch nicht abgeschlossen | Lieferart und Bestellhinweise prüfen; falls ein Abbruchbereich angeboten wird, Abbruch beantragen |
| In Bearbeitung | Wird manuell bearbeitet oder über Partnerkanal freigeschaltet | Originalbestellung beibehalten, nicht erneut kaufen; gemäß Aufforderung Daten ergänzen oder korrigieren |
| Geliefert | Lieferinhalte oder Freischaltungsergebnis bereitgestellt | Bei fertigem Konto Anmeldung und Spezifikation prüfen; bei Aufladung Mitgliedschaft prüfen; Geschenkkarte gemäß Anleitung einlösen |
| Storniert | Ursprüngliche Bestellung wurde beendet | Stornogrund und Wallet-Buchungen prüfen; ob eine Rückerstattung erfolgt, richtet sich nach dem tatsächlichen Nachweis |
Der detaillierte Fortschritt einer Aufladung kann auf Warten auf Lieferant, Warten auf Freischaltung, notwendige Datenkorrektur oder laufende Rückerstattung hinweisen. Dieser Fortschritt unterscheidet sich vom endgültigen Abschlussstatus; beurteilen Sie das Ergebnis der Freischaltung oder Rückerstattung nicht allein anhand eines einzelnen Fehlers.
## Häufige Fragen
### Betrag abgebucht, aber Konto oder Mitgliedschaft nicht erhalten
Öffnen Sie zuerst die Bestelldetails und prüfen Sie Status und Lieferinhalte. Manuelle Lieferung und Aufladung sind nicht immer sofort abgeschlossen; kontaktieren Sie den Support, wenn die in der Warenbeschreibung angegebene Frist überschritten wird, der Status lange nicht aktualisiert wird oder abnormal angezeigt wird, und zahlen Sie nicht erneut.
### Daten falsch eingegeben
Nur aktualisieren, wenn die Originalbestellung einen Korrekturbereich anzeigt; Zielkonto prüfen und dann absenden. Ohne Korrekturbereich oder bereits geliefert: zuerst Support kontaktieren; es wird nicht zugesichert, dass bereits freigeschaltete Abonnements übertragen werden können.
### Bestellung zeigt Abschluss, Plattform hat noch keine Mitgliedschaft
Bestätigen Sie, dass Sie mit dem angegebenen Zielkonto angemeldet sind, aktualisieren Sie die Seite oder melden Sie sich erneut an und prüfen Sie die Abonnementeinstellungen. Wenn weiterhin Abweichungen bestehen: geschwärzte Screenshots und Bestellnummer aufbewahren und Support kontaktieren, nicht selbst eine zweite Bestellung aufgeben.
### Konto gesperrt oder Identitätsprüfung verlangt
Widerspruch oder Verifizierung über die offiziellen Wege der Drittplattform einlegen. Nach erfolgreicher Lieferung oder Aufladung erfolgt keine Rückerstattung wegen Sperrung; wir können beim Widerspruch unterstützen, aber eine Entsperrung wird nicht zugesichert. Abweichungen wie Nichtlieferung gemäß Vereinbarung werden gemäß[After-Sales-Regeln](/de/docs/store-rules/) separat behandelt.
### Wo ist die Rückerstattung?
Prüfen Sie den Stornogrund und die Wallet-Buchungen. Die Gutschrift auf das Wallet-Guthaben unterscheidet sich von einer Rückerstattung auf das ursprüngliche Zahlungsmittel; eine als in Bearbeitung angezeigte Rückerstattung ist noch nicht abgeschlossen, reichen Sie keinen identischen Antrag erneut ein.
### Was muss ich beim Supportkontakt angeben?
Bestellnummer, Ware und Spezifikation, Zeitpunkt und Zeitzone, Bestellstatus, geschwärzte Fehlermeldungen. Senden Sie keine Passwörter, Bestätigungscodes, vollständige Session-JSON, Einlösecodes oder API-Schlüssel.
---
# Handels- und Nachkaufregeln des Shops
Source: https://1zheai.com/de/docs/store-rules/
Markdown: https://1zheai.com/de/docs/store-rules.md
---
title: "Handels- und Nachkaufregeln des Shops"
description: "Unterscheidung nach Bestellphase: Stornierung, Lieferungsprobleme, Aktivierungsfehler und Kontosperrung; Modell-API-Guthaben wird separat nach den Aufladeregeln behandelt."
headingIds: {"Informationen vor der Bestellung":"section-1","Stornierung und Rückerstattung nach Bestellphase":"section-2","Sperrungsrisiko muss separat verstanden werden":"section-3","Unterschied zur API-Guthabenrückerstattung":"section-4","Wenn Sie Nachkauf benötigen":"section-5"}
---
## Informationen vor der Bestellung
Preis, Spezifikation, Menge, Region, Dauer, Lieferart und Risikohinweise werden im Produkt- oder Checkout-Prozess angezeigt. Bitte lesen Sie diese vor der Bestätigung vollständig und kontaktieren Sie den Support, wenn Bedingungen unklar sind. Die Bestellung behält die zum Zeitpunkt der Bestellung bestätigten Produkt- und Risikohinweise; spätere Seitenaktualisierungen ändern nicht die Bestätigungsdaten historischer Bestellungen.
Diese Website ist Ihr Zugang zum Kauf von Produkten und zur Beantragung von Nachkauf. Wenn Lieferpartner beteiligt sind, prüft und bearbeitet diese Website anhand der Bestellung; zahlen Sie nicht separat an unbekannte Upstream-Quellen und benötigen Sie kein eigenes Vertriebskonto.
## Stornierung und Rückerstattung nach Bestellphase
| Situation | Vorgehensweise |
| --- | --- |
| Warte auf Lieferung und die Bestellung bietet eine Stornierungsoption | Stornierung über die ursprüngliche Bestellung beantragen, nach Erfolg die Wallet-Rückerstattungsabrechnung prüfen |
| Wird verarbeitet oder Aktivierungsergebnis steht aus | Kann nicht direkt storniert werden; ursprüngliche Bestellung behalten und auf Prüfung warten, nicht erneut kaufen |
| Anmeldung nicht möglich, Lieferung ungültig oder Spezifikation stimmt nicht überein | Bestellnummer und geschwärzte Nachweise bereitstellen, damit der Support die Lieferung prüft |
| Aufladung fehlgeschlagen oder Daten fehlerhaft | Nach den Hinweisen der ursprünglichen Bestellung korrigieren oder Support kontaktieren; eine Fehlermeldung bedeutet nicht, dass bereits erstattet wurde |
| Fertiges Konto wurde normal geliefert oder Aufladung war erfolgreich, danach von einer Drittplattform gesperrt | Keine Rückerstattung wegen Sperrung; Beschwerde kann unterstützt werden, Entsperrung wird nicht zugesagt |
| Guthabenkarte wurde geliefert | Keine direkte Rückerstattung; bei ungültiger Lieferung oder anderen Problemen kann der Support kontaktiert werden |
## Sperrungsrisiko muss separat verstanden werden
Nach normaler Lieferung eines fertigen Kontos oder erfolgreicher Aufladung wird bei Sperrung des Kontos durch eine Drittplattform nicht wegen der Sperrung erstattet. Wir können bei der Beschwerde unterstützen, das Ergebnis der Entsperrung wird jedoch nicht zugesagt. Bei Nichtlieferung wie vereinbart, erfolgloser Aufladung oder Fällen, in denen die Website gesetzlich verantwortlich ist, gelten die entsprechenden Nachkaufregeln.
Drittplattformen können Bedingungen anpassen, den Zugang einschränken oder Identitätsverifizierung verlangen; diese Website kann nicht garantieren, dass keine Risikokontrollen auftreten, keine Sperrungen erfolgen oder eine Beschwerde erfolgreich ist. Verwechseln Sie nicht die Sperrung nach normaler Lieferung mit Nichtlieferung wie vereinbart oder einem fehlgeschlagenen Aktivierungsvorgang. Die obigen Ausführungen schließen gesetzlich vorgeschriebene Haftung der Website nicht aus.
## Unterschied zur API-Guthabenrückerstattung
Die Rückerstattung des ungenutzten Kapitals bei Modell-API wird gemäß[ Aufladung, Rückerstattung und Rechnung](/de/docs/billing/) behandelt. Ob Shopprodukte storniert werden können und wie erstattet wird, richtet sich nach der Bestellphase und den entsprechenden Produktregeln; die 7-Tage-Regel des API-Guthabens wird nicht direkt angewendet. Stornierung einer Bestellung mit Rückbuchung ins Wallet und Rückerstattung einer Wallet-Aufladung auf demselben Weg sind zwei verschiedene Vorgänge.
## Wenn Sie Nachkauf benötigen
Über[ Meine Bestellungen](https://1zheai.com/store-orders?lng=de) die Bestellnummer bereithalten und Produktspezifikation, Zeitpunkt des Vorfalls, Bestellstatus, den von der Drittplattform angezeigten Status und geschwärzte Fehler-Screenshots bereitstellen. Kontakt über die auf der Website oder im Konsolenbereich veröffentlichten Supportkanäle; keine Passwörter, Verifizierungscodes, vollständigen Sitzungen, Einlösecodes oder Originalausweise bereitstellen. Wie Sie das konkrete Problem eingrenzen, siehe[ Bestellungsprobleme diagnostizieren](/de/docs/store-orders/).
---
# Einladungsbelohnungen und Shop-Rabatte
Source: https://1zheai.com/de/docs/affiliate-guide/
Markdown: https://1zheai.com/de/docs/affiliate-guide.md
---
title: "Einladungsbelohnungen und Shop-Rabatte"
description: "Erfahren Sie mehr über die Einladungszuordnung von Shop-Rabatten, teilnehmende Produkte, Abrechnungsbedingungen und Provisionsstatus."
headingIds: {"So nehmen Sie teil":"section-1","Welche Bestellungen Provisionen erzeugen":"section-2","Wann wird abgerechnet":"section-3","Wo Sie nachschauen können":"section-4"}
---
Bestellungen berechtigter Shop-Produkte können Empfehlungsprämien bringen. Der Administrator legt die Teilnahme für jedes Konto-, Abonnementaktivierungs- und Geschenkkartenprodukt einzeln fest; nicht jedes Produkt bringt automatisch eine Provision.
## So nehmen Sie teil
Kopieren Sie Ihren eigenen Registrierungslink über den Einladungseingang im Kontrollpanel[Wallet](https://1zheai.com/wallet?lng=de). Wenn ein Freund sich über diesen Link registriert, wird die im System erfasste Einladungsbeziehung beibehalten. Wenn der Freund eine Bestellung aufgibt, wird die Provisionszugehörigkeit entsprechend bestimmt; sie wird nicht durch das spätere Klicken auf den Link einer anderen Person geändert, und die Einladernummer wird nicht im Bestellformular übermittelt.
Freunde, mit denen bereits eine Einladungsbeziehung besteht, die nach der Aktivierung der Funktion teilnehmende Produkte kaufen, werden ebenfalls nach den Regeln für neue Bestellungen behandelt. Bestellungen vor der Aktivierung der Funktion werden nicht mit Shop-Provisionen nachträglich gutgeschrieben. Eigene Käufe zählen nicht als eigene Einladungsprovision.
## Welche Bestellungen Provisionen erzeugen
Der Administrator konfiguriert für jede Produktvariante eine feste Provision; das Eintragen von 0 bedeutet keine Teilnahme. Varianten, für die die tatsächliche Provision noch nicht konfiguriert ist, werden keine Belohnung auszahlen. Bei der Bestellung werden der damalige Einlader, das Produkt, die Menge und der Provisionsbetrag erfasst; spätere Anpassungen des Produktpreises oder der Provision ändern bereits erfasste Bestellungsdaten nicht.
Shop-Rabatte und Registrierungsbelohnungen sind zwei getrennte Arten von Datensätzen. Eine Aufladung des Wallets durch einen Freund entspricht nicht dem Kauf eines Produkts und erzeugt auch nicht automatisch eine Shop-Provision. Ob eine Registrierungsbelohnung ausgezahlt wird, richtet sich nach den bestehenden Einladungsbelohnungseinstellungen des Administrators.
## Wann wird abgerechnet
| Bestellstatus | Provisionsbehandlung |
| --- | --- |
| Ausstehende Lieferung, in Bearbeitung oder Lieferergebnis ausstehend | Nur geschätzte Provision wird erfasst, keine Überweisung auf das Guthaben möglich |
| Erfolgreiche Lieferung eines Fertigkontos oder einer Geschenkkarte, abgeschlossene Abo-Aufladung | Vom System abgerechnet und dem Belohnungsguthaben gutgeschrieben |
| Bestellung storniert und erstattet | Geschätzte Provision wird ungültig, keine Belohnung ausgezahlt |
| Doppelte Bestellübermittlung oder doppelte Verarbeitung einer Abschlussbenachrichtigung | Dieselbe Bestellung wird nur einmal abgerechnet |
Ein Fehler oder Timeout bei einer Bestellung bedeutet nicht, dass die Lieferung erfolgt ist; ob eine Provision entstanden ist, kann nicht allein anhand eines einzelnen Verarbeitungsergebnisses beurteilt werden. Eine nach erfolgreicher Lieferung des Kontos oder erfolgreicher Abo-Aufladung erfolgende Sperre wird gemäß den[Shop-Nachkaufregeln](/de/docs/store-rules/) behandelt.
Wenn das Empfängerkonto der Belohnung deaktiviert wurde oder den Systembetragsgrenzwert erreicht hat, bleibt die Provision im Status "ausstehende Abrechnung" und wird nach Wiederherstellung der Bedingungen erneut versucht; dies beeinflusst die Lieferung der Bestellung des Käufers nicht. Wenn die Systemzahlungs- und Belohnungsfunktion ausgesetzt ist, wird auch die Abrechnung ausgesetzt.
## Wo Sie nachschauen können
Im Wallet zeigt "Neueste Shop-Provisionen" die Produkte, Varianten, Mengen, Beträge und Status der kürzlich teilnehmenden Bestellungen an:
- **Ausstehende Abrechnung**: Geschätzter Betrag, noch nicht in verfügbare Belohnungen eingerechnet.
- **Gutgeschrieben**: Bereits dem Belohnungsguthaben gutgeschrieben, nicht zusätzlich zu verfügbaren Belohnungen addieren.
- **Ungültig**: Für diesen Betrag wird keine Provision mehr ausgezahlt.
Verfügbare Belohnungen nutzen den bestehenden Überweisungseingang auf das Guthaben und die Mindestüberweisungsanforderung und können für Modell-API-Nutzung verwendet werden. Belohnungen sind kein Barauszahlungsbetrag und entsprechen nicht den aufgeladenen verfügbaren Shop-Mitteln; der Shop prüft weiterhin nach seinen eigenen Mittelberechtigungsregeln.
Einlader können nur ihre eigenen Provisionsdatensätze einsehen. Datensätze zeigen keine Identität des Käufers, Bestellnummer, Kontokennwort oder Einlösecode. Wenn Sie Provisionen abgleichen müssen, geben Sie über die auf der offiziellen Website veröffentlichten Supportkanäle die Provisionsdatensatznummer, das Produkt und den Zeitpunkt an; fordern Sie keine Zugangsdaten des Käufers an.
---
# Anleitung zur Tool-Anbindung für Claude und GPT
Source: https://1zheai.com/de/docs/integrations/
Markdown: https://1zheai.com/de/docs/integrations.md
---
title: "Anleitung zur Tool-Anbindung für Claude und GPT"
description: "API-Konfigurationsanleitungen und Unterstützungsumfang für Claude Code, Codex CLI, OpenCode, OpenClaw, WorkBuddy, Hermes Agent, Cursor, Cline, Cherry Studio und CC Switch."
headingIds: {"Programmier-Tools":"section-1","Desktop-Assistenten":"section-2","Weitere Clients und Importmethoden":"section-3","Agent-Plattformen":"section-4","Konfigurationsverwaltung":"section-5","Weitere Tools mit benutzerdefinierter API":"section-6","So bestätigst du eine erfolgreiche Konfiguration":"section-7"}
---
Gehe je nach dem von dir verwendeten Tool zur entsprechenden Anleitung. Der unten stehende Status basiert auf den vorhandenen Anbindungs-Dokumenten und bedeutet nicht, dass alle Tool-Versionen Ende-zu-Ende verifiziert wurden. Führe nach einem Tool-Upgrade die Aufrufverifizierung auf der Seite erneut durch.
## Programmier-Tools
Native Anthropic-Anbindung. Umgebungsvariablen, Konfigurationsdateien und häufige Probleme. Aufruf von OpenAI-/GPT-Modellen über die Responses-Schnittstelle. Unterscheidung zwischen v1- und v2-Konfiguration, benutzerdefinierte OpenAI-kompatible Anbieter. OpenAI-kompatible Anbindung. Zuerst den Geltungsbereich und die Oberflächenunterschiede benutzerdefinierter Schlüssel prüfen. Anthropic-Modus bevorzugt verwenden, OpenAI-Compatible-Konfiguration wird ebenfalls bereitgestellt.
## Desktop-Assistenten
Benutzerdefinierten Anbieter im Chat-Client hinzufügen. Benutzerdefinierte Adresse über die Modelleinstellungen hinzufügen, auf vollständige URL und Protokollschalter achten.
## Weitere Clients und Importmethoden
Import-Link oder JSON aus der Zwischenablage, manuelle Ersatzkonfiguration wird unterstützt. Anbieter-QR-Code für Android, Schlüsselinhalt standardmäßig ausgeblendet. Benutzerdefinierte Anbieterfelder und Modellkonfiguration. Administrator-YAML-Endpunkt und unabhängige Benutzerschlüssel. Anthropic-Konfiguration für die VS-Code-Erweiterung.
Das Ein-Klick-Protokoll dient ausschließlich für Vorgänge, die der Client bereits öffentlich unterstützt. Das Gesprächsöffnungs-Protokoll von ChatWise entspricht nicht dem Import eines Schlüssels; LibreChat erfordert eine Administrator-Konfiguration. Behandle nicht alle Tools als denselben Import-Link.
## Agent-Plattformen
Benutzerdefinierten Anthropic-Anbieter und Standard-Agent-Modell konfigurieren. Chat Completions über den Modell-Assistenten oder einen benannten Provider konfigurieren. Die Anleitungen für OpenCode, OpenClaw, WorkBuddy und Hermes Agent wurden mit der offiziellen Konfiguration abgeglichen, die Ende-zu-Ende-Verifizierung auf dieser Website ist noch nicht abgeschlossen. Prüfe anhand der Anleitung die tatsächliche Version und verifiziere die Aufrufe.
## Konfigurationsverwaltung
Verwaltung der Anbieterkonfiguration für Claude Code, um manuelles Umschalten zu reduzieren.
## Weitere Tools mit benutzerdefinierter API
Prüfe zuerst, ob das Tool die API-Adresse, den Schlüssel und die Modell-ID einstellen kann, und wähle dann die Konfiguration entsprechend dem Protokoll:
| Vom Tool unterstützte Protokolle | Schnittstelle dieser Website | Nächster Schritt |
| --- | --- | --- |
| Anthropic Messages | `/v1/messages` | Prüfen, ob der Client `/v1` automatisch anhängt, siehe [Adressbeschreibung ](/de/docs/base-url/) |
| OpenAI Chat Completions | `/v1/chat/completions` | In der Regel Base URL mit `https://1zheai.com/v1` ausfüllen; Ausnahme sind Felder für vollständige Endpunkte |
| OpenAI Responses | `/v1/responses` | Base URL mit `https://1zheai.com/v1` ausfüllen, siehe [Codex CLI ](/de/docs/quickstart-codex/) |
| Nur offizieller Kontologin | API-Schlüssel dieser Website nicht verwenden | Prüfen, ob das Tool eine separate Einstellung für benutzerdefinierte Anbieter hat |
## So bestätigst du eine erfolgreiche Konfiguration
1. Wähle laut Anleitung Protokoll und Base URL; ob ein Tool `/v1` benötigt, siehe [Adresstabelle ](/de/docs/base-url/).
2. Wähle ein aktuell verfügbares Modell aus [unterstützten Modellen ](/de/docs/models/).
3. Starte eine kurze Anfrage und prüfe, ob das Tool normal antwortet.
4. Prüfe den entsprechenden Aufruf im [Aufrufprotokoll ](/de/docs/usage-logs/); beurteile nicht allein anhand des Antwortinhalts, über welchen Anbieter die Anfrage lief.
Bei Problemen zuerst [Fehlercodes und Fehlersuche ](/de/docs/troubleshooting/) ansehen. Wenn du selbst Programme schreibst, gehe zum [Entwicklerleitfaden ](/de/docs/guides/).
---
# Claude Code-Anbindung
Source: https://1zheai.com/de/docs/quickstart-claude-code/
Markdown: https://1zheai.com/de/docs/quickstart-claude-code.md
---
title: "Claude Code-Anbindung"
description: "Claude Code an 1折AI anbinden: mit ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN (Umgebungsvariablen oder settings.json), inkl. Windows-Schreibweise, Modellzuordnung, VS-Code-Plugin und häufiger Fehler."
headingIds: {"Kürzester Weg":"section-1","Vollständige Schritte":"section-2","Warum ANTHROPIC_AUTH_TOKEN verwenden":"section-3","Modellzuordnung":"section-4","VS-Code-Plugin":"section-5","Optionale Einstellungen":"section-6","Häufige Probleme":"section-7"}
---
Claude Code benötigt nur zwei Variablen: `ANTHROPIC_BASE_URL` zeigt auf uns, `ANTHROPIC_AUTH_TOKEN` enthält deinen API-Schlüssel (API key). Ein Anthropic-Konto ist nicht nötig.
## Kürzester Weg
Wenn Claude Code bereits installiert ist und du einen API-Schlüssel hast, trage die beiden folgenden Zeilen in `~/.claude/settings.json` ein und führe dann `claude` aus:
```json title="~/.claude/settings.json"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Wenn die Datei bereits existiert, füge diese beiden Einträge in die bestehende `env` ein und überschreibe keine anderen Konfigurationen.
## Vollständige Schritte
Bereits installiert? Dann überspringe diesen Abschnitt. Die folgenden Befehle stammen aus der [offiziellen Claude-Code-Installationsdokumentation](https://code.claude.com/docs/en/setup):
```bash title="macOS / Linux"
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell title="Windows PowerShell"
irm https://claude.ai/install.ps1 | iex
```
```bash title="Homebrew"
brew install --cask claude-code
```
```bash title="npm（需要 Node.js 22+）"
npm install -g @anthropic-ai/claude-code
```
Bei der Installation mit npm nicht `sudo` hinzufügen.
Erstelle im [Konsolenbereich](https://1zheai.com/console?lng=de) einen neuen API-Schlüssel, empfehlensweise speziell für Claude Code auf diesem Rechner. Siehe [API-Schlüssel abrufen und verwalten](/de/docs/api-keys/).
Speicherort von settings.json: macOS / Linux ist `~/.claude/settings.json`, Windows ist `%USERPROFILE%\.claude\settings.json`.
```json title="settings.json（推荐）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
```bash title="macOS / Linux 环境变量"
# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
```
```powershell title="Windows PowerShell"
# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
```
```bat title="Windows CMD"
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
```
`ANTHROPIC_BASE_URL` enthält die Basisadresse, ohne `/v1`; Claude Code hängt `/v1/messages` selbst an.
Führe im Projektverzeichnis `claude` aus und gib danach `/status` ein. Achte auf zwei Zeilen:
- Die Zeile für die Basis-URL zeigt `https://1zheai.com`
- Die Zeile für die Anmeldedaten zeigt als Quelle `ANTHROPIC_AUTH_TOKEN`
Stelle dann eine Frage und prüfe im [Aufrufprotokoll](/de/docs/usage-logs/), ob ein neuer Eintrag vorhanden ist. Wenn ja, ist die Verbindung hergestellt.
Wenn du nicht in die interaktive Oberfläche wechseln möchtest, kannst du es auch im nicht-interaktiven Modus testen (am 2026-10-15 getestet, Rückgabe `ok`):
```bash
claude -p "say ok" --model claude-sonnet-4-6
```
## Warum ANTHROPIC_AUTH_TOKEN verwenden
Claude Code hat zwei Variablen, in die ein API-Schlüssel eingetragen werden kann. Der Unterschied ([offizielle Erläuterung](https://code.claude.com/docs/en/authentication)):
| Variable | Übertragung | Verhalten |
|---|---|---|
| `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | Nach dem Setzen sofort wirksam, keine Bestätigungsabfrage |
| `ANTHROPIC_API_KEY` | `x-api-key: <值>` | Im interaktiven Modus fragt es beim ersten Mal, ob dieser API-Schlüssel verwendet werden soll |
Beide werden unterstützt, empfohlen wird `ANTHROPIC_AUTH_TOKEN`. **Nur eine der beiden setzen**: Falls in deinem System noch eine frühere offizielle `ANTHROPIC_API_KEY` vorhanden ist, lösche sie, damit keine Mischung zu 401 führt.
Zwei weitere leicht übersehbare Regeln:
- Wenn `settings.json` in `env` und ein Terminal-Export dieselbe Variable gesetzt haben, **gilt settings.json**. Wenn die Terminal-Änderung nicht greift, prüfe zuerst settings.json.
- Trage den API-Schlüssel nicht in die `.claude/settings.json` des Projekts ein; diese Datei wird üblicherweise ins Repository eingecheckt. Für eine Unterscheidung nach Projekten nutze die nicht eingecheckte `.claude/settings.local.json`.
## Modellzuordnung
`opus`, `sonnet`, `haiku` und `fable` in Claude Code sind Aliase; über Umgebungsvariablen lässt sich festlegen, welches konkrete Modell sie ansprechen. Die Haiku-Stufe wird von Claude Code zusätzlich für einige kleine Hintergrundaufgaben verwendet.
| Variable | Zweck | Beispielwert |
|---|---|---|
| `ANTHROPIC_MODEL` | Modell beim Start | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Ziel des Aliases `opus` | `claude-opus-5-5` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Ziel des Aliases `sonnet` | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Modell für den Alias `haiku` und Hintergrundaufgaben | `claude-haiku-5-5` |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Ziel des Aliases `fable` | `claude-fable-5-1` |
```json title="~/.claude/settings.json（带模型映射）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
}
}
```
Die Modell-ID muss zu den [unterstützten Modellen](/de/docs/models/) gehören. Während einer laufenden Sitzung lässt sich mit `/model claude-opus-5-5` vorübergehend wechseln.
## VS-Code-Plugin
Das VS-Code-Plugin von Claude Code prüft die Anmeldedaten vor dem Start; offiziell empfohlen wird, die Variablen in den eigenen VS-Code-Benutzereinstellungen zu setzen (Befehlspalette → Preferences: Open User Settings (JSON)):
```json title="VS Code settings.json"
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
]
}
```
Wenn nur `~/.claude/settings.json` gesetzt ist, kann die eigene Anmeldeprüfung des Plugins die Werte möglicherweise nicht lesen.
## Optionale Einstellungen
| Variable | Zweck |
|---|---|
| `API_TIMEOUT_MS` | Anfrage-Timeout, Standard 600000 (10 Minuten); bei langen Aufgaben kann ein größerer Wert helfen |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | Schaltet automatische Updates, Telemetrie, Fehlerberichte usw. ab. Achtung: Werte wie `0` oder `false` gelten ebenfalls als aktiviert; zum Abschalten muss die Variable gelöscht werden |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | Verwenden bei 400-Fehlern wie "Extra inputs are not permitted" |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | Lässt die `/model`-Liste verfügbare Modelle von `/v1/models` abrufen |
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` wurde getestet und funktioniert (Claude Code 2.1.296, 2026-10-15): Nach dem Start erscheint im Debug-Log `[gatewayDiscovery] cached 14 models`, die 14 Modelle stimmen mit den [unterstützten Modellen](/de/docs/models/) überein.
Setze `DISABLE_PROMPT_CACHING` nicht; es deaktiviert den Cache, die Rechnung wird deutlich höher, siehe [Prompt Caching](/de/docs/prompt-caching/).
## Häufige Probleme
Claude Code hat den API-Schlüssel nicht gelesen. Prüfe die Schreibweise des Variablennamens; bei Umgebungsvariablen stelle sicher, dass in einem neu geöffneten Terminal gestartet wird; bei settings.json prüfe die JSON-Syntax (ein zusätzliches Komma macht die gesamte Konfiguration ungültig).
Der API-Schlüssel wurde unvollständig kopiert, oder `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` sind gleichzeitig vorhanden und einer davon ist ein alter Wert. Nur einen der beiden behalten. Mehr dazu unter [Fehlercodes und Fehlersuche](/de/docs/troubleshooting/).
In `ANTHROPIC_BASE_URL` wurde `/v1` zu viel geschrieben. Ändere es zu `https://1zheai.com`.
Das ist Claude Code, das mit der Haiku-Stufe kleine Hintergrundaufgaben ausführt. Für ein anderes Modell setze `ANTHROPIC_DEFAULT_HAIKU_MODEL`.
Lösche (oder kommentiere aus) die beiden obigen Variablen, um zur offiziellen Anmeldung zurückzukehren. Bei häufigem Wechsel nutze [CC Switch](/de/docs/quickstart-cc-switch/), ein Klick genügt.
Es entsteht keine Verknüpfung. Bei der Anbindung an 1折AI verwendet Claude Code unseren API-Schlüssel und meldet sich nicht bei deinem Anthropic-Konto an.
---
# Codex CLI-Anbindung
Source: https://1zheai.com/de/docs/quickstart-codex/
Markdown: https://1zheai.com/de/docs/quickstart-codex.md
---
title: "Codex CLI-Anbindung"
description: "Konfigurationsmethode für die Anbindung von OpenAI Codex CLI an 1折AI (model_providers in ~/.codex/config.toml), Aufruf von GPT-Modellen über die Responses-Schnittstelle."
headingIds: {"Konfigurationsdatei":"section-1","Codex installieren":"section-2","Häufige Fragen":"section-3"}
---
OpenAI-/GPT-Modelle sind verfügbar. Codex CLI verwendet die OpenAI-Responses-Schnittstelle (`/v1/responses`) und wird über den API-Schlüssel dieser Website angebunden. Verfügbare Modelle und Preise finden Sie im [Modellkatalog](https://1zheai.com/model-catalog?lng=de).
Zunächst wird die Konfigurationsweise des benutzerdefinierten Anbieters für Codex erläutert; das Format stammt aus der [offiziellen Codex-Konfigurationsdokumentation](https://developers.openai.com/codex/config-reference).
## Konfigurationsdatei
Die Konfiguration von Codex befindet sich in `~/.codex/config.toml`. Benutzerdefinierte Anbieter können nur in dieser benutzerbezogenen Datei angegeben werden; die Einstellung `model_provider` in `.codex/config.toml` im Projekt wird ignoriert.
```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"
[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```
Das Beispiel verwendet `gpt-6-astra`; dies kann durch eine andere GPT-Modell-ID ersetzt werden, die von Ihrem Schlüssel unterstützt wird.
Bedeutung der einzelnen Felder:
| Feld | Beschreibung |
|---|---|
| `model_provider` | Welcher Anbieter verwendet wird, entsprechend der id unter `[model_providers.]`. `openai`, `ollama` und `lmstudio` sind reservierte Namen und dürfen nicht verwendet werden |
| `base_url` | Muss `/v1` enthalten |
| `env_key` | Codex liest den API-Schlüssel (API key) aus dieser Umgebungsvariable; der Name muss exakt mit dem übereinstimmen, den Sie exportieren |
| `wire_api` | Die offizielle Dokumentation gibt an, dass derzeit nur `responses` unterstützt wird; bei Weglassen wird ebenfalls dieser verwendet |
Anschließend den API-Schlüssel in eine Umgebungsvariable setzen:
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
## Codex installieren
Die folgenden Befehle stammen aus der offiziellen Codex-Dokumentation:
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
## Häufige Fragen
Der in `env_key` angegebene Variablenname stimmt nicht mit dem übereinstimmen, den Sie tatsächlich exportieren, oder das Terminal wurde geöffnet, bevor die Umgebungsvariable gesetzt wurde. Vergleichen Sie beide Namen und öffnen Sie das Terminal erneut.
Nein. In der offiziellen Codex-Konfigurationsdokumentation akzeptiert `wire_api` ausschließlich `responses`. Dienste, die nur die Chat-Completions-Schnittstelle bereitstellen, benötigen ein zusätzliches Protokollkonvertierungswerkzeug, um mit Codex verbunden zu werden.
Sehen Sie im [Modellkatalog](https://1zheai.com/model-catalog?lng=de) die aktuellen Modelle und tragen Sie die Modell-ID in `model` ein. Starten Sie Codex und senden Sie eine kurze Anfrage; prüfen Sie Modell und Status im [Aufrufprotokoll](/de/docs/usage-logs/).
---
# OpenCode-Anbindung an die Claude-API
Source: https://1zheai.com/de/docs/quickstart-opencode/
Markdown: https://1zheai.com/de/docs/quickstart-opencode.md
---
title: "OpenCode-Anbindung an die Claude-API"
description: "Anleitung zur Konfiguration der 1折AI Claude-API-Weiterleitung in OpenCode mit Adresse, Schlüssel und Modellen, einschließlich Protokollauswahl, Konfigurationsbeispielen, Verifikationsschritten und häufigen Fehlern."
headingIds: {"OpenCode-v1-Konfiguration":"section-1","OpenCode-v2-Konfiguration":"section-2","Anbindung verifizieren und Fehler beheben":"section-3","Kosten und andere Anbindungsmethoden":"section-4"}
---
Nutze die Funktion für benutzerdefinierte Anbieter in OpenCode, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und prüfe die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele und müssen entsprechend den Berechtigungen deines Schlüssels angepasst werden.
Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Seite ist noch nicht abgeschlossen. Führe zuerst eine kurze Frage-Antwort- und Tool-Call-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live; Modellliste und Preise findest du in der [Modellbeschreibung](/de/docs/models/).
## OpenCode-v1-Konfiguration
Gemäß [offiziellen v1-Providern](https://opencode.ai/docs/providers/): Führe `/connect` aus, wähle Other, gib als Provider-ID `onezhe` ein und trage den API-Schlüssel dieser Seite ein. Im Projekt `opencode.json` zusammenführen:
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"onezhe": {
"npm": "@ai-sdk/openai-compatible",
"name": "1折AI",
"options": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Anschließend `/models` das Modell dieses Providers auswählen. `/connect` speichert nur Zugangsdaten und ersetzt nicht die Provider-Konfiguration. Hier wird explizit das SDK für Chat Completions gewählt; es darf nicht versehentlich auf `@ai-sdk/openai` für Responses umgestellt werden. Die offizielle Seite erlaubt auch die Referenzierung von Umgebungsvariablen über `options.apiKey: "{env:ONEZHE_API_KEY}"`.
## OpenCode-v2-Konfiguration
Gemäß [offiziellen v2-Providern](https://opencode.ai/v2/docs/providers) die nativen v2-Felder verwenden; sie dürfen nicht mit dem v1 von oben vermischt werden. Im Projekt `opencode.jsonc` zusammenführen:
```json
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"onezhe": {
"name": "1折AI",
"env": ["ONEZHE_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Im Prozessumfeld, das OpenCode startet, `ONEZHE_API_KEY` bereitstellen und dann `/models` `onezhe/claude-sonnet-4-6` auswählen. Der Hauptunterschied bei v2 sind `providers`, `package`, `settings` statt `provider`, `npm`, `options` bei v1. Prüfe zuerst mit `opencode --version` die verwendete Hauptversion.
Wenn natives Anthropic verwendet werden soll, erlaubt v1 offiziell das Überschreiben von `provider.anthropic.options.baseURL`; das Beispiel enthält `/v1`; v2 listet `@opencode/ai/providers/anthropic-compatible`. Dieses Tutorial folgt einer expliziten OpenAI-kompatiblen Konfiguration; das Protokoll darf nicht basierend auf dem Modellnamen eigenmächtig gewechselt werden, und es wird nicht versprochen, dass Caching und Tool-Calls bereits verifiziert sind.
## Anbindung verifizieren und Fehler beheben
1. Konfiguration speichern und neu laden, prüfen, dass der aktuell ausgewählte Anbieter `onezhe` oder das hinzugefügte benutzerdefinierte Modell ist.
2. Eine kurze Frage senden und prüfen, ob eine Antwort zurückkommt; anschließend einen kleinen, rückgängig zu machenden Auftrag versuchen und Tool-Calls sowie Mehr-Runden-Dialoge separat bestätigen.
3. Die [Aufrufprotokolle](/de/docs/usage-logs/) öffnen und Anfragezeit, Modell, Status und Verbrauch abgleichen. Eine erfolgreiche Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. Bei 404 Adresse und Protokoll dieser Seite auf Passung prüfen; bei 401 Herkunft des Schlüssels und ob der Prozess die Umgebungsvariable gelesen hat, prüfen; bei 429 Rate-Limit-Informationen ansehen und dann erneut versuchen. Weitere Fälle siehe [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/).
Schlüssel werden nur in der lokalen Umgebung oder im Zugangsdatenspeicher des Tools gespeichert und dürfen nicht in Code-Repositorys, Screenshots oder öffentliche Protokolle eingecheckt werden. Hintergrunddienste erben möglicherweise nicht die Terminal-Umgebungsvariablen; Hilfsmodelle, Suche und andere Tools haben möglicherweise eigene Anbieter-Einstellungen und müssen separat geprüft werden.
## Kosten und andere Anbindungsmethoden
Siehe [Claude-API-Echtzeitpreise](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients zum [Tool-Anbindungsverzeichnis](/de/docs/integrations/) zurückkehren; für eigene Programme die [SDK- und Entwicklungsleitfäden](/de/docs/guides/) nutzen.
---
# Cursor-Anbindung
Source: https://1zheai.com/de/docs/quickstart-cursor/
Markdown: https://1zheai.com/de/docs/quickstart-cursor.md
---
title: "Cursor-Anbindung"
description: "Claude-Modelle von 1折AI in Cursor mit eigenem OpenAI-API-Schlüssel und Base URL aufrufen, sowie welche Funktionen den benutzerdefinierten API-Schlüssel nicht verwenden."
headingIds: {"Konfiguration":"section-1","Bekannte Probleme":"section-2","Häufig gestellte Fragen":"section-3"}
---
Cursor erlaubt es, in den Einstellungen einen eigenen API-Schlüssel (API key) einzutragen; das Chat-Modell sendet Anfragen mit diesem API-Schlüssel. Nachfolgend die Vorgehensweise zur Anbindung an 1折AI sowie einige Einschränkungen, die man vorab kennen muss.
Bevor Sie loslegen, beachten Sie diese drei Punkte:
- Laut der offiziellen Cursor-Dokumentation gilt **der benutzerdefinierte API-Schlüssel nur für Chat-Modelle; Tab-Vervollständigung verwendet stets die eigenen Modelle von Cursor**.
- Anfragen werden zuerst über die Server von Cursor an die von Ihnen eingetragene Adresse weitergeleitet, daher muss die Base URL öffentlich erreichbar sein (`https://1zheai.com/v1` funktioniert, ein lokaler `localhost`-Proxy nicht).
- Der Schalter "Override OpenAI Base URL" ist in der offiziellen Cursor-Dokumentation nicht enthalten; die folgende Beschreibung der Oberfläche stammt aus dem Cursor-Forum und Community-Tutorials und kann sich nach einer Überarbeitung von Cursor ändern.
## Konfiguration
Cursor → **Cursor Settings** → **Models**, Bereich "Keys" finden.
```text
OpenAI API Key sk-你的Key（1折AI 的 Key）
Override OpenAI Base URL https://1zheai.com/v1
```
Die Base URL muss `/v1` enthalten.
In der Modellliste auf **Add model** klicken, die Modell-ID eingeben, z. B. `claude-sonnet-5-5`, und dann den Schalter dafür aktivieren. Die Modell-IDs siehe[unterstützte Modelle](/de/docs/models/).
Im Chat-Panel das gerade hinzugefügte Modell auswählen und eine Nachricht senden. Nachdem die Antwort normal erfolgt ist, im Kontrollbereich[Aufrufprotokoll](/de/docs/usage-logs/) diesen Aufruf bestätigen.
## Bekannte Probleme
Im Cursor-Forum gibt es Rückmeldungen: Nach dem Setzen von Override OpenAI Base URL können Modelle, deren Namen mit `claude-` beginnen, von Cursor als Anthropic-Modelle behandelt und an den Anthropic-API-Schlüssel übergeben werden – oder es tritt direkt ein Fehler auf. Bei der Auswahl von Claude beginnt die Modell-ID mit `claude-`; falls dieses Problem auftritt, zuerst die in Cursor eingetragenen Anthropic-API-Schlüssel löschen und erneut versuchen.
Referenz: [Forum-Beitrag 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [Forum-Beitrag 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).
## Häufig gestellte Fragen
Nein. Laut der offiziellen Cursor-Dokumentation verwendet die Tab-Vervollständigung stets die mitgelieferten Modelle von Cursor und geht nicht über Ihren API-Schlüssel.
Zuerst prüfen, ob die Base URL `/v1` enthält. Aus der Community geht hervor, dass die Verify-Schaltfläche bei Modellnamen, die nicht von OpenAI sind, nicht immer erfolgreich ist; testen Sie direkt im Chat, indem Sie eine Nachricht senden – maßgeblich ist, ob im Aufrufprotokoll ein Eintrag vorliegt.
Community-Tutorials berichten überwiegend, dass nur Chat über den benutzerdefinierten API-Schlüssel läuft; Funktionen wie Agent, Apply, Inline Edit usw. verwenden möglicherweise weiterhin das eigene Backend von Cursor. Maßgeblich sind die Einträge, die Sie tatsächlich im Aufrufprotokoll sehen.
Wenn Sie Claude hauptsächlich zum Schreiben von Code verwenden möchten, bieten [Claude Code](/de/docs/quickstart-claude-code/) (Kommandozeile oder VS-Code-Erweiterung) und [Cline](/de/docs/quickstart-cline/) eine vollständigere Unterstützung für benutzerdefinierte Adressen.
---
# Cline-Anbindung
Source: https://1zheai.com/de/docs/quickstart-cline/
Markdown: https://1zheai.com/de/docs/quickstart-cline.md
---
title: "Cline-Anbindung"
description: "Anbindung von 1折AI im Cline-Plugin für VS Code: über Anthropic Custom Base URL oder OpenAI Compatible – zwei Methoden."
headingIds: {"Methode 1: Anthropic (empfohlen)":"section-1","Methode 2: OpenAI Compatible":"section-2","Häufige Fragen":"section-3"}
---
Cline ist ein Programmier-Agent-Plugin für VS Code. Beide Methoden ermöglichen die Anbindung an 1折AI. Empfohlen wird die Anthropic-Methode, da die nativen Fähigkeiten von Claude (einschließlich Caching) vollständiger sind.
## Methode 1: Anthropic (empfohlen)
Öffne die Cline-Einstellungen und wähle unter **API Provider** **Anthropic**.
- **Anthropic API Key** (API-Schlüssel eintragen): `sk-你的Key`
- Aktiviere **Use custom base URL** und trage `https://1zheai.com` ein (ohne `/v1`)
Wähle im Modell-Dropdown ein von 1折AI [unterstütztes Modell](/de/docs/models/), z. B. `claude-sonnet-5-5`.
## Methode 2: OpenAI Compatible
Wähle unter **API Provider** **OpenAI Compatible**.
| Feld | Wert |
|---|---|
| Base URL | `https://1zheai.com/v1` |
| API Key | `sk-你的Key` |
| Model ID | `claude-sonnet-5-5` |
Klicke auf **Verify**, um die Verbindung zu bestätigen, und sende dann eine kleine Aufgabe in Cline.
In der Model Configuration kannst du das Kontextfenster und die maximale Ausgabelänge eintragen. Gib die Werte entsprechend der [offiziellen Anthropic-Modell-Dokumentation](https://platform.claude.com/docs/en/about-claude/models/overview) für das jeweilige Modell an.
## Häufige Fragen
Die Anthropic-Methode nutzt das native `/v1/messages`; Caching, Thinking und weitere Fähigkeiten sind am vollständigsten. OpenAI Compatible nutzt `/v1/chat/completions` und ist universeller. Bei Claude-Modellen sollte die Anthropic-Methode bevorzugt werden.
Die Adresse der Anthropic-Methode darf nicht `/v1` enthalten; die Adresse der OpenAI-Compatible-Methode muss `/v1` enthalten. Beides ist genau gegensätzlich.
---
# Cherry Studio Anbindung
Source: https://1zheai.com/de/docs/quickstart-cherry-studio/
Markdown: https://1zheai.com/de/docs/quickstart-cherry-studio.md
---
title: "Cherry Studio Anbindung"
description: "1折AI in Cherry Studio als benutzerdefinierten Dienstanbieter hinzufügen: Anthropic- oder OpenAI-Endpunkt wählen, Basisadresse, API-Schlüssel und Modelle eingeben."
headingIds: {"Ein-Klick-Import":"section-1","Konfiguration":"section-2","Anthropic- oder OpenAI-Endpunkt wählen":"section-3","Häufige Fragen":"section-4"}
---
Cherry Studio ist ein Desktop-Client für KI-Gespräche, in dem 1折AI als benutzerdefinierter Dienstanbieter hinzugefügt werden kann.
## Ein-Klick-Import
Im Konsole unter **API-Schlüssel → Werkzeuge → Cherry Studio** das Protokoll Anthropic oder OpenAI wählen und auf **Cherry Studio öffnen** klicken. Nach der Bestätigung des Imports in der Anwendung Modelle abrufen, Dienstanbieter aktivieren und testen. Bei einer vorhandenen Konfiguration mit demselben Namen den Überschreib-Hinweis prüfen. Der Import-Link enthält den vollständigen Schlüssel – nicht weiterleiten.
Der Browser kann nicht bestätigen, ob die Anwendung installiert ist. Wenn sie nicht gestartet wird, zuerst den Client installieren und einmal starten oder die manuellen Schritte unten verwenden. Das Protokollformat wurde mit der offiziellen Implementierung abgeglichen; das tatsächliche Reasoning muss je nach Version und Modell verifiziert werden.
## Konfiguration
Einstellungen (Zahnrad-Symbol) → **Modell-Dienste** → **+ Dienstanbieter hinzufügen** unterhalb der Liste.
| Feld | Eingabe |
|---|---|
| Anbietername | `1折AI` |
| API-Schlüssel | `sk-你的Key` |
| Endpunkt | **Anthropic** (empfohlen) oder **OpenAI** wählen |
| API-Adresse | `https://1zheai.com` |
In die API-Adresse nur die Basisadresse eintragen; Cherry Studio ergänzt je nach gewähltem Protokoll automatisch `/v1/...`. Vollständige Pfade wie `/v1/messages`, `/v1/chat/completions` nicht einfügen und am Ende kein `#` anhängen (ein abschließendes `#` bedeutet, dass kein Pfad mehr automatisch ergänzt wird).
Auf **Modellliste abrufen** klicken und die benötigten Modelle aus der zurückgegebenen Liste hinzufügen; oder auf **+** klicken und die Modell-ID manuell eingeben, z. B. `claude-sonnet-5-5`. Nur Modelle, die zur Liste hinzugefügt wurden, erscheinen in der Modellauswahl des Gesprächs.
Den Aktivierungsschalter oben rechts auf der Dienstanbieter-Seite einschalten, zur Gesprächsoberfläche zurückkehren und unter 1折AI ein Modell auswählen, um eine Nachricht zu senden.
## Anthropic- oder OpenAI-Endpunkt wählen
| Endpunkt | Geeignet für |
|---|---|
| Anthropic | Nutzung von Claude-nativen Funktionen wie extended thinking; die Protokollbeschränkungen des Agents gelten in der jeweils aktuellen Version |
| OpenAI | Gewohntes OpenAI-Format oder einheitliche Verwaltung zusammen mit anderen OpenAI-kompatiblen Diensten |
Beide Endpunkte verwenden denselben API-Schlüssel (API key) und denselben Satz von Modell-IDs.
## Häufige Fragen
Zuerst prüfen, ob der API-Schlüssel überflüssige Leerzeichen enthält; dann bestätigen, dass die API-Adresse `https://1zheai.com` ist und kein zusätzlicher Pfad eingetragen wurde. Wenn der Abruf fehlschlägt, lässt sich die Anwendung trotzdem nutzen – das manuelle Eingeben der Modell-ID funktioniert ebenfalls.
Die API-Adresse wurde als vollständiger Pfad eingetragen oder am Ende `#` angehängt. Auf die Basisadresse `https://1zheai.com` zurücksetzen.
---
# Dify-Integration
Source: https://1zheai.com/de/docs/quickstart-dify/
Markdown: https://1zheai.com/de/docs/quickstart-dify.md
---
title: "Dify-Integration"
description: "Konfiguration von 1折AI mit dem offiziellen OpenAI-API-kompatiblen Dify-Plugin, einschließlich Modelleinrichtung, Gesprächstests und Fehlerbehebung beim ersten Aufruf."
headingIds: {"Voraussetzungen":"section-1","Hinzufügen eines Modells":"section-2","Start mit dem ersten Gespräch":"section-3","Importieren des Beispiel-Chatflows":"section-4","Fehlerbehebung":"section-5","Hilfe bei der Integration erhalten":"section-6","Überprüfungsumfang":"section-7","English / Русский":"section-8"}
---
Dify-Nutzer können den OpenAI-kompatiblen Endpunkt von 1折AI über das offizielle Modell-Plugin **OpenAI-API-compatible** konfigurieren. Überprüfen Sie zuerst ein Textmodell und verwenden Sie es dann in Workflows; es ist nicht notwendig, unverifizierte Drittanbieter-Plugins zu installieren.
## Voraussetzungen
- Ein Dify-Arbeitsbereich, in dem Modell-Plugins installiert werden können.
- Ihr eigener 1折AI-API-Schlüssel sowie die Modell-IDs, die dieser Schlüssel abrufen darf. Überprüfen Sie die [Konsole](https://1zheai.com/console).
- Ausreichend verfügbares Guthaben auf Ihrem Konto. Die Validierungsanfrage beim Speichern eines Modells und Anwendungstests können normale API-Gebühren verursachen.
Senden Sie Ihren vollständigen Schlüssel nicht an den Kundensupport, schreiben Sie ihn nicht in Workflow-Beschreibungen, Screenshots oder öffentliche Repositories. Speichern Sie ihn nur im API-Key-Feld von Dify; wenn Sie einen Drittanbieter-gehosteten Dify verwenden, verwaltet diese Instanz Ihren Schlüssel und leitet Anfragen weiter.
## Hinzufügen eines Modells
1. Suchen Sie im Dify-Plugin-Marktplatz nach **OpenAI-API-compatible** und bestätigen Sie, dass der Herausgeber **langgenius** ist.
2. Öffnen Sie die Modellanbieter in den Arbeitsbereichseinstellungen, finden Sie dieses Plugin und fügen Sie ein LLM-Modell hinzu.
3. Füllen Sie die folgenden Felder aus und speichern Sie. Die Beschriftungen der Oberfläche können je nach Dify-Version variieren.
| Feld | So füllen Sie es aus |
| --- | --- |
| Model Name | Kopieren Sie die vollständige Modell-ID aus der 1折AI-Konsole; ersetzen Sie sie nicht durch den Anzeigenamen |
| API Key | Ihr eigener 1折AI-Schlüssel |
| API Base URL | `https://1zheai.com/v1` |
| Completion mode | `Chat` |
| Modellname im API-Endpunkt | Normalerweise leer lassen; wenn gesetzt, muss er mit der tatsächlichen Modell-ID übereinstimmen |
| Modellkontextgröße | Gemäß der tatsächlichen Fähigkeit des ausgewählten Modells ausfüllen; kopieren Sie nicht die Kontextlänge eines anderen Modells |
Hier benötigen Sie `/v1`. Geben Sie nicht die vollständige `/v1/chat/completions` ein und duplizieren Sie sie nicht als `/v1/v1`. Wenden Sie keine Anweisungen von anderen Clients an, die nur die Basisadresse erfordern.
## Start mit dem ersten Gespräch
Erstellen Sie eine leere Chat-App, wählen Sie das gerade gespeicherte Modell und geben Sie „Stelle in einem Satz auf Chinesisch vor, was du kannst.“ ein. Sobald eine vollständige Textantwort bestätigt ist, überprüfen Sie als Nächstes die Streaming-Ausgabe.
Überprüfen Sie die entsprechende Anfragezeit, das Modell und das Ergebnis in den Aufrufprotokollen der 1折AI-Konsole. Verlassen Sie sich nicht allein auf „Erfolgreich gespeichert“ von Dify als Beweis, dass die App verbunden ist. Erst nach dem ersten Erfolg sollten Sie Tool-Aufrufe, Vision-Eingaben oder Wissensbasis-Abfragen konfigurieren; diese Fähigkeiten hängen vom jeweiligen Modell und der Schnittstelle ab, und ein erfolgreiches Textgespräch bedeutet nicht, dass alles verfügbar ist.
## Importieren des Beispiel-Chatflows
[Laden Sie die Chatflow-Vorlage ohne Schlüssel herunter](/de/docs/downloads/1zheai-dify-chatflow.yml) und wählen Sie dann in Dify Studio **Create → Import DSL file**, um sie hochzuladen. Die Vorlage ist `User Input → LLM → Answer`, DSL-Version 0.7.0, und verwendet das offizielle kompatible Plugin 0.0.68.
Fügen Sie zuerst Ihre eigenen Anmeldedaten gemäß den obigen Schritten hinzu. Nach dem Import öffnen Sie den LLM-Knoten und bestätigen, dass Ihr eigener Anbieter und Modell ausgewählt sind, nicht das Testmodell von Dify. Die Beispiel-Modell-ID ist `claude-haiku-4-5-20251001`; wenn sie für Ihr Konto nicht verfügbar ist, wechseln Sie zu einem Modell, auf das Sie Zugriff haben, und überprüfen Sie die Fähigkeitseinstellungen. Die Vorlage enthält keinen API-Schlüssel und bietet keine kostenlosen Aufrufguthaben.
## Fehlerbehebung
| Symptom | Was zuerst zu überprüfen ist |
| --- | --- |
| 503 / Keine verfügbaren Konten | Der aktuelle Upstream ist möglicherweise rate-limitiert oder hat keine Kapazität mehr. Überprüfen Sie zuerst den Dienststatus und die Aufrufprotokolle, versuchen Sie es später mit Backoff erneut oder kontaktieren Sie den Support; wiederholen Sie keine hochfrequenten Wiederholungen und generieren Sie keine Schlüssel wiederholt neu |
| 401 / Ungültiger Schlüssel | Ob zusätzliche Leerzeichen vorhanden sind, ob der Schlüssel widerrufen wurde und ob versehentlich ein Schlüssel von einer anderen Plattform verwendet wurde |
| 404 | Ob die Base URL exakt `https://1zheai.com/v1` ist; ob die Modell-ID existiert |
| Modell nicht erlaubt oder unzureichendes Guthaben | Die Modellbeschränkungen des aktuellen Schlüssels, das verfügbare Guthaben des Kontos und das ausgewählte Modell |
| Erfolgreich gespeichert, aber die App kann nicht aufrufen | Ob die App den richtigen Anbieter und das richtige Modell ausgewählt hat; ob der Arbeitsbereichsserver die API erreichen kann |
| Normale Antworten funktionieren, Streaming schlägt fehl | Überprüfen Sie die SSE-Unterstützung des Proxys, die Plugin-Version und die Streaming-Usage-Einstellung; bewahren Sie einen geschwärzten Fehler zur Fehlerbehebung auf |
| Tool-Aufrufe oder Vision schlagen fehl | Bestätigen Sie zuerst, ob das ausgewählte Modell diese Fähigkeit tatsächlich unterstützt; erzwingen Sie sie nicht nur durch Umschalten von Plugin-Schaltern |
Anfragen von selbst-gehostetem Dify werden von dessen Server gesendet; die Tatsache, dass Ihr Browser die offizielle Website öffnen kann, bedeutet nicht, dass der Dify-Server die API erreichen kann.
## Hilfe bei der Integration erhalten
Geben Sie die Dify-Version, die Plugin-Version, die Modell-ID, den Fehlerzeitstempel, die Anfrage-ID und geschwärzte Fehlerdetails über den Online-Kundenservice der offiziellen Website an. Senden Sie nicht den vollständigen Schlüssel, Kundendaten oder private Prompts aus Ihren Workflows.
## Überprüfungsumfang
Am 2026-10-19 wurden mit dem offiziellen Plugin 0.0.68 Haiku-Textgespräche und Streaming-Aufrufe in Dify Cloud abgeschlossen und mit den Gateway-Protokollen abgeglichen. Der exportierte DSL ohne Schlüssel wurde in denselben Arbeitsbereich als neue App importiert. Nach dem Import traf ein erneuter Test auf einen durch Upstream-Rate-Limiting verursachten 503, daher wird diese Runde nicht als bestandener Post-Import-Lauf erfasst.
Dies ist ein interner Test mit einem definierten Zeitfenster, keine kontinuierliche Verfügbarkeitsgarantie. Neue Arbeitsbereiche, ältere Dify-Versionen, Tool-Aufrufe, Vision und Wissensbasis-Abfragen wurden nicht überprüft; führen Sie Ihren ersten Test mit Ihrem eigenen rate-limitierten Schlüssel durch.
[Offizielle Plugin-Quelle](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Dify-Plugin-Marktplatz](https://marketplace.dify.ai/)
## English / Русский
**English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support.
**Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.
---
# WorkBuddy-Anbindung an die Claude-API
Source: https://1zheai.com/de/docs/quickstart-workbuddy/
Markdown: https://1zheai.com/de/docs/quickstart-workbuddy.md
---
title: "WorkBuddy-Anbindung an die Claude-API"
description: "Anleitung zur Konfiguration der 1折AI Claude-API-Weiterleitung in WorkBuddy mit Adresse, Schlüssel und Modell, einschließlich Protokollauswahl, Konfigurationsbeispielen, Verifikationsschritten und häufiger Fehler."
headingIds: {"Anbindung verifizieren und Fehler beheben":"section-1","Kosten und andere Anbindungsmethoden":"section-2"}
---
Verwende die Funktion für benutzerdefinierte Anbieter in WorkBuddy, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und überprüfe die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele und müssen entsprechend den Berechtigungen deines Schlüssels angepasst werden.
Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-zu-End-Verifikation auf dieser Website ist noch nicht abgeschlossen; führe zuerst eine kurze Frage-Antwort-Prüfung und einen Tool-Aufruf-Test durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live; die Modellliste und Preise findest du in der [Modellbeschreibung](/de/docs/models/).
Gemäß [offizieller Modellkonfiguration](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model): Einstellungen → Modelle → Modell hinzufügen → Benutzerdefiniert/Custom. Trage den Schlüssel dieser Website und das Modell `claude-sonnet-4-6` ein.
Verwende die Konfiguration mit der vollständigen Anfrageadresse: Aktiviere in den erweiterten Einstellungen „Benutzerdefiniertes Protokoll“, fülle die URL mit `https://1zheai.com/v1/chat/completions` aus und wähle nach dem Speichern dieses Modell im Konversationsmodellwähler. Die offizielle Beschreibung besagt, dass beim Einschalten dieser Schalter die eingegebene URL direkt verwendet wird, ohne Pfadprüfung und automatische Vervollständigung; beim Ausschalten erfolgt die Vervollständigung gemäß Standard `/chat/completions`. Daher müssen vollständige URL und Schalter zusammen beschrieben werden.
„Benutzerdefiniertes Protokoll“ bedeutet hier nicht, dass OpenAI-Anfragen automatisch in Anthropic-Anfragen umgewandelt werden können; nach dem Eintragen von `/v1/messages` kann nicht behauptet werden, dass das native Claude-Protokoll verbunden ist. Verwende vorzugsweise die UI; es wird kein unverifiziertes manuelles Format `models.json` bereitgestellt. Die offizielle Seite zeigt gleichzeitig den aktuellen lokalen Konfigurationspfad und die alte Migrationsanweisung `~/.codebuddy/models.json`; vermeide es, den alten Pfad als allgemeinen aktuellen Pfad zu verwenden. Die Werkzeugfähigkeitsmarkierungen in der Oberfläche können die End-zu-End-Verifikation dieser Website nicht ersetzen.
## Anbindung verifizieren und Fehler beheben
1. Speichere und lade die Konfiguration neu, und stelle sicher, dass der aktuell ausgewählte Anbieter `onezhe` oder dein hinzugefügtes benutzerdefiniertes Modell ist.
2. Sende eine kurze Frage und stelle sicher, dass eine Antwort zurückkommt; versuche anschließend eine kleine, rückgängig zu machende Aufgabe und überprüfe Tool-Aufrufe und mehrstufige Konversationen getrennt.
3. Öffne das [Aufrufprotokoll](/de/docs/usage-logs/) und gleiche Anfragezeit, Modell, Status und Verbrauch ab. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. Bei 404: prüfe, ob Adresse und Protokoll dieser Anleitung zusammenpassen; bei 401: prüfe die Herkunft des Schlüssels und ob der Prozess die Umgebungsvariablen liest; bei 429: sieh dir die Rate-Limit-Informationen an und versuche es erneut. Weitere Fälle findest du unter [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/).
Speichere Schlüssel nur in der lokalen Umgebung oder im Anmeldeinformations-Speicher des Tools; reiche sie nicht in Code-Repos, Screenshots oder öffentliche Protokolle ein. Hintergrunddienste erben möglicherweise keine Terminal-Umgebungsvariablen; Hilfsmodelle, Suche und andere Tools können ebenfalls eigene Anbieter-Einstellungen haben und müssen separat geprüft werden.
## Kosten und andere Anbindungsmethoden
Siehe [Claude-API-Echtzeitpreise](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients gehe zurück zum [Tool-Anbindungsverzeichnis](/de/docs/integrations/); zum eigenständigen Programmieren nutze [SDK- und Entwicklungsleitfaden](/de/docs/guides/).
---
# Chatbox Ein-Klick-Import und Konfiguration
Source: https://1zheai.com/de/docs/quickstart-chatbox/
Markdown: https://1zheai.com/de/docs/quickstart-chatbox.md
---
title: "Chatbox Ein-Klick-Import und Konfiguration"
description: "Chatbox über die API-Schlüssel-Seite importieren und API Host, Pfad, Modell und Schlüssel überprüfen."
headingIds: {"Ein-Klick-Import":"section-1","Zwischenablage und manuelle Konfiguration":"section-2","Fehlersuche":"section-3"}
---
Ab Chatbox 1.15.1 werden Provider-JSON und `chatbox://provider/import` unterstützt. Die Desktop-Version muss zuerst installiert und einmal gestartet werden. Für die Webversion oder Systeme ohne Registrierungsprotokoll verwenden Sie bitte den Import über die Zwischenablage.
## Ein-Klick-Import
1. Öffnen Sie im Konsole **API-Schlüssel**, finden Sie den zu verwendenden Schlüssel und gehen Sie zu **Werkzeuge verwenden → Chatbox**.
2. Wählen Sie das für diesen Schlüssel verfügbare Chat-Modell und klicken Sie dann auf **Chatbox öffnen**, um die Anwendung im Browser zu öffnen.
3. Bestätigen Sie den Import in Chatbox und prüfen Sie die Provider-Adresse und das Modell. Wenn bereits eine Konfiguration mit demselben Namen existiert, überprüfen Sie zuerst den Geltungsbereich der Überschreibung.
4. Senden Sie eine kurze Nachricht und überprüfen Sie das Modell und die Anfragezeit im Aufrufprotokoll dieser Website.
## Zwischenablage und manuelle Konfiguration
Wenn die Anwendung nicht aufgerufen wird, kopieren Sie **Chatbox JSON** im selben Panel und wählen Sie in der Provider-Verwaltung in den Chatbox-Einstellungen den Import über die Zwischenablage. Vor dem Teilen mit anderen muss `settings.apiKey` entfernt werden.
| Feld | Wert |
| --- | --- |
| Typ | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | Aktueller Schlüssel |
| Model ID | Für den aktuellen Schlüssel verfügbares Chat-Modell |
Host und Pfad werden getrennt ausgefüllt. Fügen Sie `/v1` nicht gleichzeitig in beide Felder ein. Wenn kein Modell vorhanden ist, rufen Sie zuerst die Modell-Liste ab oder fügen Sie manuell hinzu; Fähigkeiten wie Bilder, Embeddings und Tool-Aufrufe müssen jeweils separat überprüft werden. Behandeln Sie nicht beliebige Modelle als Chat-Modell.
## Fehlersuche
- Anwendung erscheint nicht: Stellen Sie sicher, dass die Anwendung installiert und gestartet wurde, heben Sie die Browser-Blockierung dieses Protokolls auf oder verwenden Sie den Import über die Zwischenablage.
- 401 nach dem Import: Prüfen Sie, ob der Schlüssel gültig ist und keine Leerzeichen enthält.
- 404: Stellen Sie sicher, dass der endgültige Pfad `/v1/chat/completions` ist und nicht doppelt angehängt wurde.
- Modell nicht vorhanden: Verwenden Sie die genaue ID aus der Modell-Liste; raten Sie nicht anhand des angezeigten Spitznamens.
Offiziell: [Konfigurations-Import-Protokoll](https://docs.chatboxai.app/guides/providers/import-config), [Client-Quellcode](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).
-Protokoll mit offiziellen Unterlagen abgeglichen am 2026-10-19. Diese Website hat die Konfigurationsgenerierung und Frontend-Regressionstests umgesetzt; die echte Inferenzverifikation für alle Clients, Systeme und Modelle ist nicht abgeschlossen. Nach Client-Updates bitte erneut verifizieren. Eine benutzerdefinierte Anbindung stellt keine offizielle Partnerschaft oder eingebaute Empfehlung dar.
Mehr: [API-Schlüssel](/de/docs/api-keys/), [Modell-Liste](/de/docs/models/), [Aufrufprotokoll](/de/docs/usage-logs/), [Adressbeschreibung](/de/docs/base-url/).
---
# RikkaHub: Import per QR-Code
Source: https://1zheai.com/de/docs/quickstart-rikkahub/
Markdown: https://1zheai.com/de/docs/quickstart-rikkahub.md
---
title: "RikkaHub: Import per QR-Code"
description: "OpenAI-kompatiblen Anbieter in RikkaHub auf Android per QR-Code importieren, Modelle konfigurieren und Fehler beheben."
headingIds: {"Konfiguration per QR-Code":"section-1","Manuelle Alternative":"section-2","Fehlerbehebung":"section-3"}
---
RikkaHub ist ein KI-Client für Android. Diese Website verwendet das `ai-provider:v1:`-Teilformat, um lokale QR-Codes zu erzeugen, und ruft keine Drittanbieter-QR-Websites auf.
## Konfiguration per QR-Code
1. Konsole **API-Schlüssel → Werkzeuge → RikkaHub**.
2. In einer privaten Umgebung auf **Import-QR-Code anzeigen** klicken. Der QR-Code entspricht dem vollständigen Schlüssel und darf nicht als Screenshot weitergegeben werden.
3. In RikkaHub unter **Einstellungen → Anbieter-Einstellungen → Import** den Scan auswählen. Befinden sich beide Enden auf demselben Gerät, die Import-aus-Bild-Funktion des Clients verwenden und den den Schlüssel enthaltenden Screenshot nach dem Import löschen.
4. Nach dem Import die Modellliste abrufen, ein Chat-Modell auswählen, eine kurze Nachricht senden und anschließend die Aufrufprotokolle auf dieser Website prüfen.
5. Nach Abschluss den QR-Code ausblenden. Wurde er versehentlich an Dritte gesendet, diesen Schlüssel widerrufen und einen neuen erstellen.
## Manuelle Alternative
| Feld | Wert |
| --- | --- |
| Typ | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chat Completions Path | `/chat/completions` |
| API-Schlüssel | Aktueller Schlüssel |
Der Import stellt weder Modellfähigkeiten noch Kontextlängen voraus und aktiviert auch den Responses-Schalter nicht. Wenn Responses benötigt wird, zuerst das ausgewählte Modell und die Client-Version prüfen und anschließend separat verifizieren.
## Fehlerbehebung
Bei fehlgeschlagenem Scan zuerst prüfen, ob der QR-Code vollständig ist, der Bildschirm klar und die Client-Version korrekt; funktioniert dies nicht, die manuellen Felder verwenden. Schlägt das Abrufen der Modellliste fehl, Schlüssel und Adresse prüfen – unzureichende Berechtigungen lassen sich nicht durch erneutes Scannen beheben.
Offiziell: [Schnellstart](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [Implementierung des Teilformats](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).
Protokoll und offizielle Unterlagen wurden am 2026-10-19 abgeglichen. Diese Website implementiert die Konfigurationsgenerierung und Frontend-Regressionstests; die echte Inferenz wurde nicht für alle Clients, Systeme und Modelle verifiziert. Nach einem Client-Upgrade bitte erneut verifizieren. Eine benutzerdefinierte Anbindung stellt keine offizielle Partnerschaft oder eingebaute Empfehlung dar.
Mehr: [API-Schlüssel](/de/docs/api-keys/), [Modellliste](/de/docs/models/), [Aufrufprotokolle](/de/docs/usage-logs/), [Adressbeschreibung](/de/docs/base-url/).
---
# ChatWise Benutzerdefinierter Anbieter
Source: https://1zheai.com/de/docs/quickstart-chatwise/
Markdown: https://1zheai.com/de/docs/quickstart-chatwise.md
---
title: "ChatWise Benutzerdefinierter Anbieter"
description: "Fügen Sie in den ChatWise-Einstellungen einen OpenAI-kompatiblen Anbieter hinzu und geben Sie Schlüssel, Adresse und Modelle ein."
headingIds: {"Importfähigkeiten und Überprüfung":"section-1"}
---
Erstellen Sie einen benutzerdefinierten OpenAI-kompatiblen Anbieter unter **Settings → Providers → +** in ChatWise. Die Konsole **API-Schlüssel → Werkzeuge → ChatWise** liefert kopierbare Felder.
| Feld | Wert |
| --- | --- |
| API URL / Base URL | `https://1zheai.com/v1` |
| API Key | Aktueller Schlüssel |
| Modell | Nach dem Abrufen der Modelle auswählen oder Modell-ID manuell eingeben |
Die Modelllisten-Endpunkt ist `/v1/models`. Wenn die aktuelle Version eine vollständige Anfrageadresse anstelle einer Base URL erwartet, geben Sie `https://1zheai.com/v1/chat/completions` ein; maßgeblich ist die Feldbeschreibung. Deaktivieren Sie unnötige Drittanbieter-Proxys, bevor Sie die direkte Verbindung testen.
## Importfähigkeiten und Überprüfung
Das offiziell öffentlich zugängliche `chatwise://chat` dient zum Öffnen von Konversationen und nicht zum Import von Anbieterschlüsseln. Diese Seite tarnt es nicht als Konfigurations-Import-Schaltfläche. Bild-, Denk- und Werkzeugfähigkeiten müssen entsprechend der tatsächlichen Unterstützung des jeweiligen Modells konfiguriert werden; aktivieren Sie nicht standardmäßig alles.
Senden Sie eine kurze Nachricht und überprüfen Sie die Protokolle dieser Seite. 401: Schlüssel prüfen; 404: prüfen, ob das Adressfeld einen vollständigen Pfad erwartet; wenn keine Modelle vorhanden sind, geben Sie zunächst die aktuell verfügbare ID manuell ein.
Offiziell: [Benutzerdefinierter Anbieter](https://docs.chatwise.app/custom-provider), [Anwendungsvereinbarung öffnen](https://docs.chatwise.app/open-from-other-apps).
Vereinbarung mit offiziellen Unterlagen abgeglichen am 2026-10-19. Diese Seite hat die Konfigurationsgenerierung und Frontend-Regressionstests umgesetzt; die echte Inferenzprüfung für alle Clients, Systeme und Modelle wurde nicht abgeschlossen. Verifizieren Sie nach Client-Updates erneut. Benutzerdefinierter Zugang bedeutet keine offizielle Partnerschaft oder eingebaute Empfehlung.
Mehr: [API-Schlüssel](/de/docs/api-keys/), [Modellliste](/de/docs/models/), [Aufrufprotokolle](/de/docs/usage-logs/), [Adressbeschreibung](/de/docs/base-url/).
---
# LibreChat benutzerdefinierte Endpunkte
Source: https://1zheai.com/de/docs/quickstart-librechat/
Markdown: https://1zheai.com/de/docs/quickstart-librechat.md
---
title: "LibreChat benutzerdefinierte Endpunkte"
description: "Administratoren konfigurieren LibreChat-Endpunkte, Benutzer geben ihre eigenen API-Schlüssel ein."
headingIds: {"Administratorkonfiguration":"section-1","Überprüfung und Fehlerbehebung":"section-2"}
---
LibreChat erfordert, dass der Deploy-Administrator benutzerdefinierte Endpunkte erlaubt; normale Benutzer können die Konfiguration des Remote-Servers nicht mit den Schaltflächen dieser Website überschreiben. Die Konsole **API-Schlüssel → Werkzeuge verwenden → LibreChat** bietet ein Konfigurationsfragment.
## Administratorkonfiguration
In die bestehende `librechat.yaml` `endpoints.custom` einfügen, ohne andere Endpunkte zu überschreiben:
```yaml
endpoints:
custom:
- name: '1折AI'
apiKey: user_provided
baseURL: 'https://1zheai.com/v1'
models:
default: []
fetch: true
```
Die von der aktuellen Version geforderte Konfigurationsvalidierung anwenden und den Dienst neu starten, dann die Benutzer bitten, ihre eigenen Schlüssel in den API-Schlüsseleinstellungen von LibreChat einzugeben. Die gemeinsame Konfiguration enthält keine echten Schlüssel. Wenn das Abrufen der Modelle fehlschlägt, kann der Administrator `default` auf eine verifizierte, funktionierende Modell-ID setzen und die ausgehende Netzwerkverbindung des Servers prüfen.
## Überprüfung und Fehlerbehebung
Den neu hinzugefügten Endpunkt und das Modell auswählen, eine kurze Anfrage senden und dann die Aufrufprotokolle dieser Website prüfen. Wenn der Endpunkt nicht angezeigt wird, zuerst den Konfigurations-Mountpunkt und die Wirksamkeit des Neustarts prüfen; bei 401 den vom Benutzer eingegebenen Schlüssel prüfen; bei 404 prüfen, dass die Base URL `/v1` und nicht der vollständige Anfragepfad ist. Verwenden Sie keine nicht vertrauenswürdigen öffentlichen LibreChat-Instanzen zur Speicherung von Schlüsseln.
Offiziell: [Benutzerdefinierte Endpunktfelder](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint).
Protokoll und offizielle Unterlagen wurden am 2026-10-19 abgeglichen. Diese Website hat die Konfigurationsgenerierung und Frontend-Regressionstests umgesetzt; die echte Inferenzvalidierung für alle Clients, Systeme und Modelle ist nicht abgeschlossen. Nach Client-Upgrades bitte erneut validieren. Benutzerdefinierte Integration bedeutet keine offizielle Partnerschaft oder eingebaute Empfehlung.
Mehr: [API-Schlüssel](/de/docs/api-keys/), [Modellliste](/de/docs/models/), [Aufrufprotokolle](/de/docs/usage-logs/), [Adressbeschreibung](/de/docs/base-url/).
---
# OpenClaw-Anbindung an die Claude-API
Source: https://1zheai.com/de/docs/quickstart-openclaw/
Markdown: https://1zheai.com/de/docs/quickstart-openclaw.md
---
title: "OpenClaw-Anbindung an die Claude-API"
description: "Anleitung zur Konfiguration der 1折AI Claude-API-Weiterleitung in OpenClaw mit Adresse, Schlüssel und Modell, einschließlich Protokollauswahl, Konfigurationsbeispiel, Verifikationsschritten und häufigen Fehlern."
headingIds: {"Verbindung verifizieren und Fehler beheben":"section-1","Kosten und andere Anbindungsmethoden":"section-2"}
---
Verwende die Funktion für benutzerdefinierte Anbieter in OpenClaw, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und bestätige die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele, passe sie an die Berechtigungen deines Schlüssels an.
Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Website ist noch nicht abgeschlossen; führe zuerst eine kurze Frage-Antwort- und Tool-Aufruf-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live, Modellliste und Preise siehe [Modellbeschreibung](/de/docs/models/).
Gemäß [benutzerdefiniertem Anbieter](https://docs.openclaw.ai/gateway/config-tools/custom-providers) und [Konfigurationsbeispiel](https://docs.openclaw.ai/gateway/configuration-examples) in `~/.openclaw/openclaw.json` zusammenführen:
```json
{
"agents": {
"defaults": {
"model": { "primary": "onezhe/claude-sonnet-4-6" },
"models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
}
},
"models": {
"mode": "merge",
"providers": {
"onezhe": {
"baseUrl": "https://1zheai.com",
"apiKey": "${ONEZHE_API_KEY}",
"api": "anthropic-messages",
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
]
}
}
}
}
```
Stelle sicher, dass der Prozess, der tatsächlich das Gateway ausführt, `ONEZHE_API_KEY` lesen kann; Umgebungsvariablen im Terminal werden nicht unbedingt an einen bereits laufenden Hintergrunddienst weitergegeben. Die [offizielle Synthetic-Dokumentation](https://docs.openclaw.ai/providers/synthetic) legt fest, dass der Anthropic-Client automatisch `/v1` anhängt, daher wird hier kein `/v1` mitgeführt und kein vollständiges `/v1/messages` eingetragen.
Bei der Umstellung auf Chat Completions paarweise ersetzen durch `baseUrl: "https://1zheai.com/v1"` und `api: "openai-completions"`. Obwohl der Name completions enthält, entspricht dieser Adapter `/v1/chat/completions`; wähle nicht fälschlich `openai-responses`. Eine vorhandene Modell-Allowlist muss die übrigen Einträge behalten und das neue Modell hinzufügen. Das Beispiel erfindet keine Kosten- oder Kontextparameter; falls die Validierung der aktuell installierten Version zusätzliche Metadaten erfordert, überprüfe zuerst die tatsächlichen Modellfähigkeiten, bevor du ergänzt.
## Verbindung verifizieren und Fehler beheben
1. Konfiguration speichern und neu laden, bestätige, dass der aktuell ausgewählte Anbieter `onezhe` oder dein hinzugefügtes benutzerdefiniertes Modell ist.
2. Sende eine kurze Frage und bestätige, dass eine Antwort zurückkommt; versuche anschließend eine kleine, rückgängig zu machende Aufgabe und bestätige Tool-Aufrufe und Mehrrunden-Dialoge getrennt.
3. Öffne die [Aufrufprotokolle](/de/docs/usage-logs/) und prüfe Anfragezeit, Modell, Status und Verbrauch. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. Bei 404 Adresse und Protokoll dieser Seite auf passende Kombination prüfen; bei 401 Herkunft des Schlüssels und ob der Prozess die Umgebungsvariablen gelesen hat prüfen; bei 429 Rate-Limit-Informationen ansehen und dann erneut versuchen. Weitere Fälle siehe [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/).
Schlüssel nur in der lokalen Umgebung oder im Anmeldeinformationenspeicher des Tools speichern, nicht in Code-Repositorys, Screenshots oder öffentliche Protokolle einreichen. Hintergrunddienste erben möglicherweise die Terminal-Umgebungsvariablen nicht; Hilfsmodelle, Suche und andere Tools können ebenfalls eigene Anbieter-Einstellungen haben und müssen separat geprüft werden.
## Kosten und andere Anbindungsmethoden
Siehe [Claude-API-Echtzeitpreise](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients zurück zum [Tool-Anbindungsverzeichnis](/de/docs/integrations/); zum eigenständigen Programmieren nutze [SDK- und Entwicklungsleitfaden](/de/docs/guides/).
---
# Hermes Agent Anbindung an die Claude API
Source: https://1zheai.com/de/docs/quickstart-hermes/
Markdown: https://1zheai.com/de/docs/quickstart-hermes.md
---
title: "Hermes Agent Anbindung an die Claude API"
description: "Anleitung zur Konfiguration der 1折AI Claude API-Weiterleitung in Hermes Agent mit Adresse, Schlüssel und Modell, einschließlich Protokollauswahl, Konfigurationsbeispiel, Verifikationsschritten und häufigen Fehlern."
headingIds: {"Verifikation der Anbindung und Fehlerbehebung":"section-1","Kosten und andere Zugangswege":"section-2"}
---
Verwende die benutzerdefinierte Anbieterfunktion von Hermes Agent, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und bestätige die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele, passe sie an die Berechtigungen deines Schlüssels an.
Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Website ist noch nicht abgeschlossen; führe zuerst eine kurze Frage-Antwort- und Tool-Call-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live, Modellliste und Preise siehe [Modellbeschreibung](/de/docs/models/).
Gemäß [offiziellen Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers): Im Terminal ausführen `hermes model` → Custom endpoint, im API mode explizit `chat_completions` auswählen, Base URL mit `https://1zheai.com/v1` ausfüllen, Schlüssel und Modell eingeben. Wähle nicht die ChatGPT-/Codex-Anmeldung, das ist ein anderer Zugangsweg.
Wiederverwendbare benannte Provider-Konfiguration, zusammenführen in `~/.hermes/config.yaml`:
```yaml
providers:
onezhe:
api: https://1zheai.com/v1
key_env: ONEZHE_API_KEY
transport: chat_completions
default_model: claude-sonnet-4-6
model:
provider: custom:onezhe
default: claude-sonnet-4-6
```
Lokal bereitstellen in `~/.hermes/.env`:
```dotenv
ONEZHE_API_KEY=sk-替换为本站密钥
```
Nach der Konfiguration kannst du im Gespräch zwischen `/model custom:onezhe:claude-sonnet-4-6` wechseln. `/model` kann das Erstellen neuer Provider über das Terminal `hermes model` nicht ersetzen. Offiziell wird `anthropic_messages`-Übertragung unterstützt, dieses Tutorial verwendet jedoch Chat Completions, um automatische Protokollerraten anhand der URL zu vermeiden. `OPENAI_BASE_URL` ist keine universelle Konfiguration für alle benutzerdefinierten Provider; die explizite Konfiguration oben sollte verwendet werden.
## Verifikation der Anbindung und Fehlerbehebung
1. Konfiguration speichern und neu laden, bestätige, dass der aktuell ausgewählte Anbieter `onezhe` oder das hinzugefügte benutzerdefinierte Modell ist.
2. Sende eine kurze Frage und bestätige, dass eine Antwort zurückkommt; versuche anschließend eine kleine, rückgängig zu machende Aufgabe und bestätige Tool-Call und Mehrfachrundengespräch einzeln.
3. Öffne die [Aufrufprotokolle](/de/docs/usage-logs/) und prüfe Anfragezeit, Modell, Status und Verbrauch. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. Bei 404: prüfe, ob Adresse und Protokoll dieses Artikels zusammenpassen; bei 401: prüfe die Herkunft des Schlüssels und ob der Prozess die Umgebungsvariablen liest; bei 429: sieh dir die Rate-Limit-Informationen an und versuche es erneut. Weitere Fälle siehe [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/).
Schlüssel werden nur in der lokalen Umgebung oder im Credential-Speicher des Tools gespeichert, nicht in Code-Repositories, Screenshots oder öffentlichen Protokollen. Hintergrunddienste erben möglicherweise die Terminal-Umgebungsvariablen nicht; Hilfsmodelle, Suche und andere Tools haben möglicherweise eigene Anbieter-Einstellungen, die separat geprüft werden müssen.
## Kosten und andere Zugangswege
Siehe [Claude-API-Echtzeitpreise](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients gehe zurück zum [Tool-Zugangskatalog](/de/docs/integrations/); zum eigenständigen Programmieren nutze die [SDK- und Entwicklungsanleitung](/de/docs/guides/).
---
# Mit CC Switch verbinden
Source: https://1zheai.com/de/docs/quickstart-cc-switch/
Markdown: https://1zheai.com/de/docs/quickstart-cc-switch.md
---
title: "Mit CC Switch verbinden"
description: "Füge 1折AI mit einer benutzerdefinierten Konfiguration in CC Switch hinzu und wechsle Claude Code mit einem Klick zwischen Anbietern, ohne settings.json manuell zu bearbeiten."
headingIds: {"Installation":"section-1","1折AI zu Claude Code hinzufügen":"section-2","Modellliste abrufen":"section-3","Codex":"section-4","Häufige Fragen":"section-5"}
---
[CC Switch](https://github.com/farion1231/cc-switch) ist ein Desktop-Tool, mit dem du die Anbieterkonfigurationen für Kommandozeilen-Tools wie Claude Code und Codex verwaltest. Nach einmaligem Hinzufügen wechselst du mit einem einzigen Klick zwischen dem offiziellen Konto, 1折AI und anderen Anbietern.
## Installation
- macOS: `brew install --cask cc-switch`
- Windows / Linux: Installationspaket auf [GitHub Releases](https://github.com/farion1231/cc-switch/releases) herunterladen
## 1折AI zu Claude Code hinzufügen
Wähle **Claude Code** in der Seitenleiste und klicke auf **Anbieter hinzufügen** (+-Symbol) rechts im Seitenkopf.
1折AI ist derzeit nicht in der Voreinstellungsliste von CC Switch enthalten. Wähle **Benutzerdefinierte Konfiguration** ganz oben in der Liste.
Gib `1折AI` als Namen ein und schreibe `env` im Konfigurationseditor so:
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Wenn du das Modell gleichzeitig festlegen möchtest, füge Variablen wie `ANTHROPIC_MODEL` hinzu. Die Schreibweise findest du im Abschnitt Modellzuordnung unter [Claude Code-Anbindung](/de/docs/quickstart-claude-code/).
Klicke auf **Hinzufügen** in der Fußzeile und aktiviere dann 1折AI in der Anbieterliste. CC Switch schreibt die Konfiguration in die `~/.claude/settings.json` von Claude Code; Claude Code verwendet den neuen Anbieter ohne Neustart.
Führe `/status` in Claude Code aus; die Base URL sollte `https://1zheai.com` sein. Sende dann eine Nachricht und prüfe im Kontrollprotokoll[Anrufrufen](/de/docs/usage-logs/), ob ein Eintrag vorliegt.
Das offizielle CC Switch-Beispiel verwendet `ANTHROPIC_API_KEY`; beide Variablen funktionieren. Wir empfehlen `ANTHROPIC_AUTH_TOKEN`, die Begründung findest du unter [Claude Code-Anbindung](/de/docs/quickstart-claude-code/).
## Modellliste abrufen
Beim Bearbeiten eines Anbieters ruft die Schaltfläche **Modellliste abrufen** neben dem Modelleingabefeld mit deinem API-Schlüssel (API key) `/v1/models` auf, listet die verfügbaren Modelle auf und du wählst eines aus, um es einzutragen.
## Codex
CC Switch kann auch die Anbieter für Codex verwalten. Die Konfiguration der Base URL, des API-Schlüssels und der GPT-Modelle dieser Website findest du unter [Codex-CLI-Anbindung](/de/docs/quickstart-codex/).
## Häufige Fragen
Prüfe zuerst in CC Switch, ob 1折AI aktiviert ist; prüfe dann im Terminal, ob `ANTHROPIC_BASE_URL` oder `ANTHROPIC_AUTH_TOKEN` exportiert wurden. Claude Code richtet sich nach settings.json, aber manuell exportierte alte Variablen können leicht zu Fehleinschätzungen führen. Es empfiehlt sich, alle zu löschen und die Verwaltung einheitlich CC Switch zu überlassen.
Der API-Schlüssel ist falsch eingegeben oder wurde gelöscht. Kopiere den API-Schlüssel erneut und achte darauf, dass keine Leerzeichen enthalten sind.
---
# CC Provider Konfiguration
Source: https://1zheai.com/de/docs/quickstart-cc-provider/
Markdown: https://1zheai.com/de/docs/quickstart-cc-provider.md
---
title: "CC Provider Konfiguration"
description: "Verwalten Sie benutzerdefinierte Anthropic-Anbieter mit der CC Provider-Erweiterung für VS Code."
headingIds: {"Konfigurationsschritte":"section-1","Geltungsbereich und Fehlersuche":"section-2"}
---
Hier ist die VS-Code-Erweiterung **onetooken/cc-provider** gemeint, nicht CC Switch. Sie unterstützt benutzerdefinierte, Anthropic-kompatible Endpunkte.
## Konfigurationsschritte
1. Installieren Sie die Erweiterung aus dem offiziellen Repository-Link und öffnen Sie deren Anbieter-Panel.
2. Erstellen Sie einen neuen benutzerdefinierten Anbieter; unter **API-Schlüssel → Werkzeuge verwenden → CC Provider** in der Konsole können Sie die entsprechenden Felder kopieren.
3. Füllen Sie den Namen mit `1折AI`, die Base URL mit `https://1zheai.com` und das API-Token mit Ihrem eigenen Schlüssel.
4. Füllen Sie das Hauptmodell und die benötigten Modellplätze anhand der aktuell verfügbaren Modelle aus; übernehmen Sie keine Modell-IDs oder Fähigkeits-Suffixe wie `[1m]` anderer Anbieter.
5. Sichern Sie vor der Anwendung Ihre bestehende Claude-Code-Konfiguration und prüfen Sie die Felder, die geändert werden. Testen Sie nach dem Neustart der Sitzungen, die die Konfiguration einlesen müssen, eine kurze Anfrage.
## Geltungsbereich und Fehlersuche
Diese Website bietet Feldkopien an; das Ein-Klick-Importprotokoll für Anbieter dieser Erweiterung wurde noch nicht verifiziert. Das Verhalten dieses Clients beim Schreiben der Claude-Code-Konfiguration unterscheidet sich von der integrierten Anbieteraufnahme.
Bei 401 Token prüfen; bei 404 prüfen, ob die Anthropic-Basisadresse nicht versehentlich mit `/v1/messages` befüllt wurde; wenn das Modell nicht existiert, verwenden Sie ein mit dem aktuellen Schlüssel verfügbares Modell. Stellen Sie sicher, dass die Anfrage im Aufrufprotokoll dieser Website erscheint, bevor Sie lange Aufgaben verwenden.
Offiziell: [CC Provider](https://github.com/onetooken/cc-provider).
Protokoll mit offiziellen Unterlagen abgeglichen am 2026-10-19. Diese Website hat die Konfigurationsgenerierung und Frontend-Regressionstests umgesetzt; die echte Inferenzverifikation für alle Clients, Systeme und Modelle ist nicht abgeschlossen. Nach Client-Upgrades bitte erneut verifizieren. Benutzerdefinierte Anbindung bedeutet keine offizielle Partnerschaft oder integrierte Empfehlung.
Mehr: [API-Schlüssel](/de/docs/api-keys/), [Modellliste](/de/docs/models/), [Aufrufprotokoll](/de/docs/usage-logs/), [Adressbeschreibung](/de/docs/base-url/).
---
# Entwicklungsleitfaden
Source: https://1zheai.com/de/docs/guides/
Markdown: https://1zheai.com/de/docs/guides.md
---
title: "Entwicklungsleitfaden"
description: "SDK- oder HTTP-Zugang wählen, von der ersten Anfrage bis zu Streaming-Ausgabe und Caching."
headingIds: {"Nach der Integration weiter ausbauen":"section-1","Von Beispielen zur Anwendung":"section-2"}
---
Bei vorhandenem Code mit dem entsprechenden SDK beginnen; wenn noch kein Technologie-Stack gewählt wurde, den Aufruf zuerst mit curl prüfen und dann in die Anwendung integrieren.
verwendet das Claude-native Protokoll, mit Beispielen für Python und TypeScript. ruft GPT oder Claude über das OpenAI SDK auf, mit Konfiguration von Modell-ID und Endpunkt-Adresse. zeigt HTTP-Anfragen direkt, um SDK-Konfigurationsunterschiede auszuschließen. bestätigt Endpunkt, Protokoll und Anwendungsbereich.
## Nach der Integration weiter ausbauen
- [Streaming-Ausgabe](/de/docs/streaming/): inkrementelle Antworten und Verbindungsabbrüche verarbeiten.
- [Prompt Caching](/de/docs/prompt-caching/): Nutzungsbedingungen und Ergebnisabgleich verstehen.
- [Fehlercodes und Fehlerbehebung](/de/docs/troubleshooting/): anhand des konkreten Fehlers Konfigurations- oder Upstream-Probleme lokalisieren.
- [Nutzungsprotokoll und Abrechnung](/de/docs/usage-logs/): Anfrageaufzeichnungen abgleichen.
Bei fertiger Software direkt mit der [Werkzeug-Integration](/de/docs/integrations/) beginnen.
## Von Beispielen zur Anwendung
Python / Node.js, von der Einrichtung der Umgebungsvariablen bis zum Ausführen des Programms. unterscheidet Konfigurationsfehler, vorübergehende Störungen und unbestimmte Ergebnisse. prüft Schritt für Schritt nach Adresse, Schlüssel, Modell und Protokoll. verwendet die Images-Schnittstelle und speichert die erzeugten Ergebnisse.
---
# Anthropic SDK-Integration (Python / TypeScript)
Source: https://1zheai.com/de/docs/quickstart-anthropic-sdk/
Markdown: https://1zheai.com/de/docs/quickstart-anthropic-sdk.md
---
title: "Anthropic SDK-Integration (Python / TypeScript)"
description: "1折AI über die offiziellen Anthropic-SDKs aufrufen: base_url auf https://1zheai.com setzen; nativer Support für Caching, Streaming, Tool-Aufrufe und Thinking."
headingIds: {"Installation":"section-1","Aufruf":"section-2","Streaming-Ausgabe":"section-3","Aufruf mit Caching":"section-4","Verwendung von Umgebungsvariablen":"section-5","Häufige Fragen":"section-6","Anfrage- und Antwortstruktur":"section-7"}
---
Die offiziellen Anthropic-SDKs nutzen das native `/v1/messages`; alle Parameter von Claude können direkt verwendet werden. Zu ändern sind nur `base_url` und `api_key`.
## Installation
```bash title="Python"
pip install anthropic
```
```bash title="TypeScript / Node.js"
npm install @anthropic-ai/sdk
```
## Aufruf
```python title="Python"
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://1zheai.com",
api_key=os.environ["ONEZHE_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(message.model)
print(message.content[0].text)
print(message.usage)
```
```typescript title="TypeScript"
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://1zheai.com",
apiKey: process.env.ONEZHE_API_KEY,
});
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(message.model);
console.log(message.content);
console.log(message.usage);
```
`base_url` mit der Basisadresse eintragen, ohne `/v1` anzuhängen.
## Streaming-Ausgabe
```python title="Python"
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "写一首四行的诗"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
```
```typescript title="TypeScript"
const stream = client.messages.stream({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "写一首四行的诗" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();
```
## Aufruf mit Caching
Lange, unveränderliche Inhalte in `system` legen und `cache_control` hinzufügen:
```python title="Python"
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
system=[
{
"type": "text",
"text": LONG_PROJECT_CONTEXT, # 每次都一样的长文本
"cache_control": {"type": "ephemeral"},
}
],
messages=[{"role": "user", "content": "根据上面的说明回答：..."}],
)
print(message.usage.cache_creation_input_tokens, message.usage.cache_read_input_tokens)
```
Beim zweiten Aufruf bedeutet `cache_read_input_tokens` größer als 0 einen Cache-Treffer. Details siehe [Prompt Caching](/de/docs/prompt-caching/).
## Verwendung von Umgebungsvariablen
Die offiziellen SDKs lesen `ANTHROPIC_BASE_URL` und `ANTHROPIC_API_KEY`; beim Erstellen des Clients müssen keine Parameter übergeben werden:
```bash
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_API_KEY="sk-你的Key"
```
Anschließend den Client ohne Parameter erstellen:
```python
client = anthropic.Anthropic() # 自动读取上面两个变量
```
Falls auf diesem Rechner auch Claude Code diese beiden Variablen liest, werden beide auf 1折AI umgestellt – in der Regel genau das Gewünschte.
## Häufige Fragen
In `base_url` wurde zu viel `/v1` eingetragen. Das Anthropic SDK fügt `/v1/messages` selbst zusammen.
API-Schlüssel (API key) prüfen; zusätzlich liest das SDK auch `ANTHROPIC_AUTH_TOKEN`, falls diese in der Umgebung vorhanden ist (z. B. ein alter, früher für Claude Code gesetzter Wert) – alten Wert löschen und erneut versuchen.
## Anfrage- und Antwortstruktur
Für system, Inhaltsblöcke und Stopp-Gründe die Details der [Messages-Schnittstelle](/de/docs/api-messages/) einsehen. Ein vollständiges Programm sollte Text anhand des Blocktyps lesen und nicht annehmen, dass der erste Block immer text ist.
---
# OpenAI SDK-Integration (Python / Node)
Source: https://1zheai.com/de/docs/quickstart-openai-sdk/
Markdown: https://1zheai.com/de/docs/quickstart-openai-sdk.md
---
title: "OpenAI SDK-Integration (Python / Node)"
description: "GPT- und Claude-Modelle von 1折AI über die offiziellen OpenAI-SDKs aufrufen: Nur base_url und api_key ändern, mit Streaming-Beispiel und Umgebungsvariablen-Schreibweise."
headingIds: {"Installation":"section-1","Aufruf":"section-2","Streaming-Ausgabe":"section-3","Umgebungsvariablen verwenden, ohne Code zu ändern":"section-4","Wann man zum Anthropic SDK wechseln sollte":"section-5","Häufige Fragen":"section-6","Responses und vollständige Programme":"section-7"}
---
Wenn bereits Code mit dem OpenAI SDK geschrieben wurde, braucht man für 1折AI nur zwei Parameter zu ändern: `base_url` und `api_key`. Als Modellname die aktuell verfügbare GPT- oder Claude-Modell-ID eintragen.
## Installation
```bash title="Python"
pip install openai
```
```bash title="Node.js"
npm install openai
```
## Aufruf
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
base_url="https://1zheai.com/v1",
api_key=os.environ["ONEZHE_API_KEY"],
)
resp = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "用一句话解释什么是 prompt caching"}],
)
print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://1zheai.com/v1",
apiKey: process.env.ONEZHE_API_KEY,
});
const resp = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句话解释什么是 prompt caching" }],
});
console.log(resp.model);
console.log(resp.choices[0].message.content);
console.log(resp.usage);
```
`base_url` muss `/v1` enthalten.
## Streaming-Ausgabe
```python title="Python"
stream = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "写一首四行的诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
```
```javascript title="Node.js"
const stream = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "写一首四行的诗" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```
## Umgebungsvariablen verwenden, ohne Code zu ändern
Die offiziellen OpenAI-SDKs (Python und Node) lesen `OPENAI_BASE_URL` und `OPENAI_API_KEY`. Wenn im Code keine Parameter übergeben werden, reicht es, diese beiden Variablen zu setzen, um umzuschalten:
```bash
export OPENAI_BASE_URL="https://1zheai.com/v1"
export OPENAI_API_KEY="sk-你的Key"
```
Beachten: Dies betrifft alle Programme in derselben Umgebung, die das OpenAI SDK verwenden.
## Wann man zum Anthropic SDK wechseln sollte
Die OpenAI-kompatible Schnittstelle eignet sich für "bereits vorhandenen Code, nur das Modell wechseln". Wenn `cache_control` für Prompt Caching, extended thinking oder das Tool-Call-Format von Claude benötigt werden, ist der Weg über das [Anthropic SDK](/de/docs/quickstart-anthropic-sdk/) zur nativen Schnittstelle besser geeignet.
## Häufige Fragen
`base_url` fehlt `/v1`. Das OpenAI SDK hängt nur `/chat/completions` hinten an.
Ja. Die OpenAI-/GPT-Modelle sind online; bitte die Modell-ID verwenden, die in [unterstützten Modellen](/de/docs/models/) mit deinem Schlüssel aufrufbar ist.
## Responses und vollständige Programme
Für das Responses-Protokoll die [Responses-Schnittstelle](/de/docs/api-responses/) ansehen. Beim ersten Einsatz mit Python oder Node.js kann das [vollständige Beispiel](/de/docs/code-examples/) direkt ausgeführt werden; vor dem Produktivbetrieb [Timeouts und begrenzte Wiederholungen](/de/docs/retries/) konfigurieren.
---
# curl-Aufrufe
Source: https://1zheai.com/de/docs/quickstart-curl/
Markdown: https://1zheai.com/de/docs/quickstart-curl.md
---
title: "curl-Aufrufe"
description: "Ohne SDK installieren, 1折AI über curl aufrufen: /v1/messages und /v1/chat/completions, Modellliste abfragen, Cache testen, Streaming-Ausgabe ansehen."
headingIds: {"Anthropic-nativ: /v1/messages":"section-1","OpenAI-kompatibel: /v1/chat/completions":"section-2","Modellliste: /v1/models":"section-3","Streaming-Ausgabe":"section-4","Cache testen":"section-5","-i beim Troubleshooting hinzufügen":"section-6"}
---
curl ist die schnellste Möglichkeit, zu prüfen, ob "API-Schlüssel (API key) und Adresse" tatsächlich funktionieren. Jeder der folgenden Befehle kann direkt kopiert werden. Zuerst den API-Schlüssel in eine Umgebungsvariable setzen:
```bash
export ONEZHE_API_KEY="sk-你的Key"
```
Windows-Nutzer sollten diese Befehle in WSL oder Git Bash ausführen; die Schreibweise für PowerShell siehe[Schnellstart](/de/docs/quickstart/).
## Anthropic-nativ: /v1/messages
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "ping"}]
}'
```
## OpenAI-kompatibel: /v1/chat/completions
```bash
curl https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Modellliste: /v1/models
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
## Streaming-Ausgabe
`"stream": true` hinzufügen und mit `-N` das Puffern von curl deaktivieren, um die Abschnittsweise Rückgabe zu sehen:
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"stream": true,
"messages": [{"role": "user", "content": "从一数到五"}]
}'
```
Das Ereignisformat siehe[Streaming-Ausgabe](/de/docs/streaming/).
## Cache testen
Dieselbe Anfrage zweimal hintereinander senden: Wenn der `usage.cache_read_input_tokens` in der zweiten Antwort größer als 0 ist, war es ein Treffer. Der Text in `system` muss die minimale cachebare Länge des Modells erreichen. Das vollständige Skript siehe[Modelle und Verbrauch prüfen](/de/docs/verify-model/), das Prinzip siehe [Prompt Caching](/de/docs/prompt-caching/).
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 32,
"system": [{
"type": "text",
"text": "把一段至少 512 token、每次都一样的长文本放在这里",
"cache_control": {"type": "ephemeral"}
}],
"messages": [{"role": "user", "content": "ping"}]
}'
```
## -i beim Troubleshooting hinzufügen
```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```
`-i` gibt den Statuscode und die Antwortheader aus. Die Bedeutung der Statuscodes siehe[Fehlercodes und Troubleshooting](/de/docs/troubleshooting/).
---
# Ausführbare Codebeispiele
Source: https://1zheai.com/de/docs/code-examples/
Markdown: https://1zheai.com/de/docs/code-examples.md
---
title: "Ausführbare Codebeispiele"
description: "Vollständige Chat-Completions-Programme für Python und Node.js, einschließlich Umgebungsvorbereitung, Modellauswahl, Fehlerbehandlung und Ausführungsbefehlen."
headingIds: {"1. Umgebungsvariablen vorbereiten":"section-1","2. Sprache auswählen und ausführen":"section-2","Python":"section-3","Node.js":"section-4","3. Ergebnis überprüfen":"section-5","Weiter ausbauen":"section-6"}
---
Die beiden folgenden Programme erledigen dasselbe: Sie lesen Umgebungsvariablen, senden eine nicht-streamende Textanfrage und geben die Antwort oder einen lokalisierbaren Fehler aus. Die Beispiele deaktivieren automatische Wiederholungen, um das Ergebnis einer einzelnen Anfrage überprüfen zu können.
## 1. Umgebungsvariablen vorbereiten
Im selben Terminal festlegen, in dem das Programm ausgeführt wird; `ONEZHE_MODEL` kann durch die ID aus[verfügbare Modelle mit Schlüssel](/de/docs/api-models/)ersetzt werden.
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
export ONEZHE_MODEL="gpt-5.6-sol"
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$env:ONEZHE_MODEL = "gpt-5.6-sol"
```
## 2. Sprache auswählen und ausführen
### Python
`python -m pip install openai` installieren, als `chat.py` speichern, `python chat.py` ausführen.
```python
import os
import sys
import openai
api_key = os.environ.get("ONEZHE_API_KEY")
if not api_key:
sys.exit("请先设置 ONEZHE_API_KEY 环境变量。")
client = openai.OpenAI(
api_key=api_key,
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
try:
response = client.chat.completions.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-5.6-sol"),
messages=[{"role": "user", "content": "用一句中文解释 DNS。"}],
)
if not response.choices:
sys.exit("响应没有 choices，请检查响应协议。")
choice = response.choices[0]
print(choice.message.content or "本次响应没有普通文本。")
print("finish_reason:", choice.finish_reason)
print("response_id:", response.id)
except openai.APIStatusError as exc:
print("HTTP:", exc.status_code, "request_id:", exc.request_id, file=sys.stderr)
print("请查看控制台日志和错误码文档；不要公开密钥。", file=sys.stderr)
sys.exit(1)
except openai.APIConnectionError:
sys.exit("连接失败或超时：检查网络与代理，再核对调用日志。")
```
### Node.js
`npm install openai` installieren, als `chat.mjs` speichern, `node chat.mjs` ausführen. Die Verwendung der Erweiterung `.mjs` aktiviert ES Module direkt.
```javascript
import OpenAI from "openai";
if (!process.env.ONEZHE_API_KEY) {
console.error("请先设置 ONEZHE_API_KEY 环境变量。");
process.exit(1);
}
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 0,
});
try {
const response = await client.chat.completions.create({
model: process.env.ONEZHE_MODEL || "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句中文解释 DNS。" }],
});
const choice = response.choices[0];
if (!choice) throw new Error("响应没有 choices，请检查响应协议。");
console.log(choice.message.content || "本次响应没有普通文本。");
console.log("finish_reason:", choice.finish_reason);
console.log("response_id:", response.id);
} catch (error) {
if (error instanceof OpenAI.APIError) {
console.error("HTTP:", error.status, "request_id:", error.request_id);
console.error("请检查网络、控制台日志和错误码文档。");
} else {
console.error(error instanceof Error ? error.message : "未知错误");
}
process.exitCode = 1;
}
```
## 3. Ergebnis überprüfen
Eine Antwort und der Beendigungsgrund sollten sichtbar sein. Wenn `finish_reason` nicht `stop` ist, prüfen, ob es sich um einen Tool-Aufruf oder eine Abbruch handelt. Die Anfrage-ID des SDKs kann leer sein; der Server kann die Trace-ID auch im Fehlerkörper platzieren. Beim Fehlersuche die desensitisierte Rohantwort ergänzen.
Die[Aufrufprotokolle](/de/docs/usage-logs/)zum Abgleich der Aufrufe verwenden. Der Exit-Status des Programms und das Vorhandensein von normalem Text decken nicht alle Geschäftserfolgsbedingungen ab; Struktur und Inhalt gemäß Ihrer Aufgabe prüfen.
## Weiter ausbauen
- [Chat Completions](/de/docs/api-chat-completions/): Mehrstufige Historie und Feldbeschreibungen.
- [Messages](/de/docs/api-messages/): Claude-native Inhaltsblöcke.
- [Responses](/de/docs/api-responses/): GPT Responses und Streaming-Ereignisse.
- [Bildgenerierung](/de/docs/api-images/): Bilder generieren und Bilddateien speichern.
- [Timeout und Wiederholungen](/de/docs/retries/): Fehlerbehandlung vor dem Produktivbetrieb konfigurieren.
---
# Streaming
Source: https://1zheai.com/de/docs/streaming/
Markdown: https://1zheai.com/de/docs/streaming.md
---
title: "Streaming"
description: "Streaming auf 1折AI: Anthoropics natives SSE-Ereignisformat, OpenAI-kompatible Chunk-Formatierung und der Umgang mit abgebrochenen Streams."
headingIds: {"Anthropic nativ":"section-1","OpenAI-kompatibel":"section-2","Was tun, wenn der Stream abbricht":"section-3","Abrechnung bei Abbruch in der Mitte":"section-4"}
---
Für lange Antworten Streaming verwenden (`"stream": true`), damit das erste Wort schneller erscheint und die Anfrage nicht durch zu lange Bearbeitungszeit von Zwischen-Netzwerken abgebrochen wird. Beide Protokolle werden unterstützt, das Format entspricht jeweils dem offiziellen.
## Anthropic nativ
Im Request `"stream": true` hinzufügen, die Antwort ist ein Server-Sent-Events-Stream. Ein normaler Stream läuft in dieser Reihenfolge (aus der [Anthropic Streaming-Dokumentation](https://platform.claude.com/docs/en/build-with-claude/streaming)):
| Ereignis | Bedeutung |
|---|---|
| `message_start` | Nachrichtenbeginn, mit Modell und anfänglichem `usage` |
| `content_block_start` | Beginn eines Inhaltsblocks (Text, thinking, tool_use) |
| `content_block_delta` | Inkrementelle Inhaltsaktualisierung, Text steht in `delta.text` |
| `content_block_stop` | Ende dieses Inhaltsblocks |
| `message_delta` | Nachrichtenaktualisierung, mit `stop_reason` und der finalen Anzahl an Output-Token |
| `message_stop` | Ende der gesamten Nachricht |
Dazwischen können `ping`-Ereignisse auftreten, diese können ignoriert werden; bei Fehlern wird ein `error`-Ereignis empfangen.
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"stream":true,
"messages":[{"role":"user","content":"从一数到五"}]}'
```
Bei Verwendung eines SDK müssen die Ereignisse nicht selbst geparst werden, siehe die Streaming-Beispiele in der [Anthropic SDK](/de/docs/quickstart-anthropic-sdk/).
## OpenAI-kompatibel
`/v1/chat/completions` mit `"stream": true` ergänzen, die Antwort sind Chunks im Format `data: {...}`, der Text steht in `choices[0].delta.content`, der Stream endet mit `data: [DONE]`. SDK-Beispiele siehe [OpenAI SDK](/de/docs/quickstart-openai-sdk/).
Der letzte Chunk vor `[DONE]` enthält `usage`, `choices` ist ein leeres Array. Wird auch zurückgegeben, wenn `stream_options.include_usage` nicht übergeben wird. Am 2026-10-15 getesteter vollständiger Stream:
```text
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":"ok"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop"}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[],"usage":{"prompt_tokens":370,"completion_tokens":4,"total_tokens":374}}
data: [DONE]
```
Beim Verarbeiten von Chunks zuerst prüfen, ob `choices` leer ist; das Beispiel auf der OpenAI-SDK-Seite ist bereits so geschrieben.
## Was tun, wenn der Stream abbricht
- Zuerst prüfen, ob ein Proxy im Spiel ist: Proxy deaktivieren und direkt verbinden, dann erneut versuchen.
- Das Lese-Timeout des Clients muss länger sein als die Generierungszeit des Modells; bei langen Ausgaben das Timeout erhöhen.
- `overloaded_error` aus dem `error`-Ereignis empfangen: einige Sekunden warten und erneut versuchen, siehe [Fehlercodes und Fehlersuche](/de/docs/troubleshooting/).
## Abrechnung bei Abbruch in der Mitte
Ein in der Mitte abgebrochener Request ist nicht kostenlos, abgerechnet werden die bis zum Abbruch bereits generierten Output-Token, protokolliert im Aufruf-Log. Die abgerechnete Ausgabe kann etwas größer sein als das, was der Client tatsächlich erhalten hat. Am 2026-10-15 getestet: Das Modell sollte von 1 bis 600 zählen, der Client brach nach 4 Sekunden ab und erhielt 188 Zeilen (ca. 380 Output-Token), im Aufruf-Log standen 750 Token. Bei unerwünschten langen Ausgaben ist es besser, von Anfang an `max_tokens` klein zu setzen, statt den Stream in der Mitte abzubrechen.
---
# Prompt-Caching: Nutzung und Abrechnung
Source: https://1zheai.com/de/docs/prompt-caching/
Markdown: https://1zheai.com/de/docs/prompt-caching.md
---
title: "Prompt-Caching: Nutzung und Abrechnung"
description: "Prompt Caching mit Claude auf 1折AI: Aktivierung, Mindestlänge, Trefferbestätigung, Abrechnung von Treffern und das Caching-Verhalten von Claude Code."
headingIds: {"Fazit zuerst":"section-1","So aktivieren Sie es":"section-2","Minimale cachierbare Länge":"section-3","Treffer bestätigen":"section-4","So wird abgerechnet":"section-5","1-Stunden-Cache":"section-6","Caching in Claude Code":"section-7","Kann die OpenAI-kompatible Schnittstelle Caching verwenden?":"section-8","FAQ":"section-9"}
---
Prompt Caching ermöglicht es, dass das lange Präfix, das Sie wiederholt senden (System-Prompt, Tool-Definitionen, lange Dokumente, Gesprächsverlauf), beim ersten Mal nur als Schreibvorgang abgerechnet wird und danach als Lesevorgang. Auf dieser Seite werden Cache-Lesevorgänge und Cache-Schreibvorgänge zu den offiziellen Listenpreisen abgerechnet, ohne den auf Ein-/Ausgabe angewandten Rabatt. Die Cache-Einheitspreise je Modell sind unter [Modelle und Preise](https://1zheai.com/en/pricing/) aufgeführt.
## Fazit zuerst
- **Claude Code hat Caching standardmäßig aktiviert**; es wirkt, sobald Sie sich verbinden.
- Beim Aufruf aus eigenem Code fügen Sie `cache_control` zum Inhaltsblock hinzu, den Sie cachen möchten, und verwenden dabei das native `/v1/messages`. Die OpenAI-kompatible Schnittstelle cacht derzeit nicht.
- Um festzustellen, ob ein Treffer stattgefunden hat, prüfen Sie ausschließlich, ob `usage.cache_read_input_tokens` der Antwort größer als 0 ist.
- Der Cache lebt standardmäßig 5 Minuten, und jeder Treffer setzt den Timer zurück. Sie können auch `"ttl": "1h"` verwenden, um einen 1-Stunden-Cache zu schreiben, zu einem höheren Schreibpreis.
## So aktivieren Sie es
Fügen Sie `"cache_control": {"type": "ephemeral"}` zu einem Inhaltsblock in system, tools oder messages hinzu; dieser Block und alles, was davor steht, wird gecacht. Eine einzelne Anfrage kann höchstens 4 Cache-Breakpoints haben.
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": [
{
"type": "text",
"text": "这里放一段很长、每次都一样的内容：项目说明、代码规范、参考文档……",
"cache_control": {"type": "ephemeral"}
}
],
"messages": [{"role": "user", "content": "根据上面的规范，审查这段代码：..."}]
}'
```
Ist das zu cachende Präfix zu kurz, wird die Anfrage normal verarbeitet, aber einfach nicht gecacht, und es wird kein Fehler ausgelöst. Die Mindestlänge variiert je nach Modell; siehe die Tabelle unten.
## Minimale cachierbare Länge
Das Folgende stammt aus [Anthropics offizieller Dokumentation](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) (2026-10-14):
| Minimale Token-Anzahl | Modelle |
|---|---|
| 512 | Fable 5.1, Fable 5, Opus 5.5, Opus 5, Sonnet 5.5, Haiku 5.5 |
| 1.024 | Opus 4.8, Sonnet 5, Sonnet 4.6, Sonnet 4.5 |
| 2.048 | Opus 4.7 |
| 4.096 | Opus 4.6, Opus 4.5, Haiku 4.5 |
## Treffer bestätigen
Senden Sie dieselbe Anfrage zweimal (nicht mehr als 5 Minuten auseinander) und vergleichen Sie das `usage` beider. Nachfolgend die tatsächlichen Ergebnisse, gemessen am 2026-10-15 mit `claude-sonnet-5-5`, mit etwa 18.000 Tokens festem Text im System:
```json title="第一次：写入缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 17920,
"cache_read_input_tokens": 0,
"cache_creation": {"ephemeral_5m_input_tokens": 17920, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
```json title="第二次：命中缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 17920,
"cache_creation": {"ephemeral_5m_input_tokens": 0, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
Ist das zweite `cache_read_input_tokens` größer als 0, wird der Cache gelesen. Die Cache-Schreib- und Cache-Lese-Tokens jedes Aufrufs erscheinen auch in der Spalte Token des [Aufrufprotokolls](/de/docs/usage-logs/), wobei Lesevorgänge als „cache↓“ und Schreibvorgänge als „↑“ erfasst werden.
## So wird abgerechnet
| Typ | Offizieller Einheitspreis | 1折AI-Einheitspreis |
|---|---|---|
| Cache-Schreiben (5 Minuten) | Eingabepreis × 1,25 | Offizieller Listenpreis, kein Rabatt |
| Cache-Schreiben (1 Stunde) | Eingabepreis × 2 | Offizieller Listenpreis, kein Rabatt |
| Cache-Lesen | Eingabepreis × 0,1 (0,05 für Opus 5.5 und Sonnet 5.5, 0,025 für Fable 5.1) | Offizieller Listenpreis, kein Rabatt |
Der offizielle Preis für einen 5-Minuten-Cache-Schreibvorgang beträgt in der Regel das 1,25-Fache des offiziellen Eingabepreises. Auf dieser Seite hat die Eingabe einen Rabatt, das Caching aber nicht; daher können Sie nicht aus dem offiziellen Multiplikator schließen, dass sich ein einzelner Cache-Lesevorgang amortisiert; Sie müssen den Modellrabatt, die Schreibkosten und die Anzahl der wiederholten Lesevorgänge vergleichen. Vollständige durchgerechnete Beispiele finden Sie unter [Preise und Abrechnung](/de/docs/pricing-explained/).
### 1-Stunden-Cache
Fügen Sie `"ttl": "1h"` zu `cache_control` hinzu, und der Cache wird 1 Stunde lang aufbewahrt — geeignet für Präfixe mit Intervallen über 5 Minuten, die weiterhin wiederholt verwendet werden:
```json
"cache_control": {"type": "ephemeral", "ttl": "1h"}
```
Schreibvorgänge werden mit dem 2-Fachen des offiziellen Eingabepreises abgerechnet, nicht mit dem rabattierten Eingabepreis; Lesevorgänge verhalten sich wie beim 5-Minuten-Cache. Die geschriebenen Tokens erscheinen in `cache_creation.ephemeral_1h_input_tokens` der Antwort. Ob Sie den 1-Stunden-Cache wählen, sollten Sie anhand des Intervalls zwischen den beiden Anfragen, der Schreibkosten und der Anzahl der wiederholten Lesevorgänge beurteilen.
## Caching in Claude Code
Claude Code platziert automatisch Cache-Breakpoints auf dem System-Prompt, den Tool-Definitionen und dem Gesprächsverlauf; [die offizielle Erläuterung finden Sie hier](https://code.claude.com/docs/zh-CN/prompt-caching). Damit es besser trifft:
- Arbeiten Sie kontinuierlich in einer Sitzung weiter; halten Sie nicht lange in der Mitte an. Der Cache läuft ab, wenn er 5 Minuten ungenutzt bleibt.
- Nachfolgende Anfragen in derselben Sitzung lesen den Cache. Gemessen am 2026-10-15 las die zweite Runde bei einer zweirundigen Claude-Code-Aufgabe 31.440 Cache-Tokens und schrieb 115 Tokens. Beim Start einer neuen Sitzung muss die erste Runde möglicherweise das gesamte Präfix neu schreiben (gemessen bei etwa 30.000 Tokens), und dieser Aufruf wird teurer als die späteren.
- Vermeiden Sie es, `CLAUDE.md` zu ändern, MCP-Server zu wechseln oder mitten in der Sitzung das Modell zu ändern; all das verändert das Präfix.
- Setzen Sie `DISABLE_PROMPT_CACHING=1` nicht; diese Umgebungsvariable schaltet das Caching für alle Modelle ab.
## Kann die OpenAI-kompatible Schnittstelle Caching verwenden?
Derzeit nicht. Gemessen am 2026-10-15 mit etwa 3.100 Tokens festem Text in der System-Nachricht von `/v1/chat/completions`, zweimal hintereinander gesendet, war unabhängig davon, ob `cache_control` zum Inhaltsblock hinzugefügt wurde, das `usage` beider Antworten:
```json
{"prompt_tokens": 3167, "completion_tokens": 4, "total_tokens": 3171}
```
Es gibt kein `prompt_tokens_details.cached_tokens`, und die Cache-Lese- und Cache-Schreibvorgänge im Aufrufprotokoll sind beide 0; die gesamte Anfrage wird zum Eingabepreis abgerechnet. Für Szenarien, die Caching benötigen, verwenden Sie bitte `/v1/messages` (Anthropic-SDK oder Claude Code).
## FAQ
Der Cache wurde geschrieben, aber die nächste Anfrage hat ihn nicht gelesen. Fehlersuche der Reihe nach: Waren die beiden Anfragen mehr als 5 Minuten auseinander? Ist der Inhalt vor dem Breakpoint byte-identisch (Zeitstempel und Zufalls-IDs im System machen ihn jedes Mal anders)? Wurde das Modell gewechselt? Hat das Präfix die obige Mindestlänge erreicht?
Die Cache-Lese- und Cache-Schreib-Tokens jedes Aufrufs stehen im Aufrufprotokoll, sodass Sie selbst nachrechnen können: Cache-Lesevorgänge ÷ (Eingabe + Cache-Schreibvorgänge + Cache-Lesevorgänge).
---
# Timeouts, Ratenbegrenzung und Wiederholungen
Source: https://1zheai.com/de/docs/retries/
Markdown: https://1zheai.com/de/docs/retries.md
---
title: "Timeouts, Ratenbegrenzung und Wiederholungen"
description: "SDK-Timeouts und begrenzte Wiederholungen konfigurierbar machen, wiederholbare Fehler von Konfigurationsfehlern unterscheiden und doppelte Übermittlungen vermeiden."
headingIds: {"Wann wiederholen":"section-1","Zuerst die eingebauten SDK-Wiederholungen nutzen":"section-2","Beim eigenen Wiederholungsmechanismus":"section-3","Ausreichend Debugging-Informationen protokollieren":"section-4"}
---
Behebe zuerst Konfigurationsfehler, dann behandle temporäre Ausfälle. Begrenze Wiederholungsanzahl, Parallelität und Gesamtwartezeit gemeinsam, um zu vermeiden, dass dieselbe fehlgeschlagene Anfrage innerhalb kurzer Zeit mehrfach erneut gesendet wird.
## Wann wiederholen
| Situation | Empfehlung |
| --- | --- |
| 400 / 401 / 403 / 404 | Zuerst Anfrage, Berechtigungen oder Modell korrigieren; die Originalanfrage nicht automatisch wiederholen |
| 429 | Antwortmeldung prüfen; bei `Retry-After` die Wartezeit beachten und Parallelität reduzieren |
| 500 / 502 / 503 / 504 / 529 | Begrenzt wiederholen; bei anhaltendem Fehlschlag stoppen und die Anfrage-ID zurückmelden |
| Verbindungsfehler | DNS, Proxy und Netzwerk prüfen und innerhalb der für die Aufgabe zulässigen Zeit begrenzt wiederholen |
| Timeout oder abgebrochener Stream nach dem Senden der Anfrage | Ergebnis kann unklar sein; zuerst Protokolle prüfen; nicht annehmen, dass der Upstream die Anfrage noch nicht verarbeitet hat |
Der Wiederholungsbereich der Clientbibliotheken stimmt nicht unbedingt vollständig mit der obigen Tabelle überein. Auf welcher Ebene wiederholt wird, dort die Strategie explizit festlegen.
## Zuerst die eingebauten SDK-Wiederholungen nutzen
Python und Node.js verwenden unterschiedliche Timeout-Einheiten: Python verwendet Sekunden, Node.js verwendet Millisekunden. Das folgende Beispiel setzt ein Timeout von 120 Sekunden und bis zu 2 automatische Wiederholungen; beim ersten Einrichten und Debugging kann auf 0 geändert werden.
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=2,
)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 2,
});
```
Die Timeout-Konfiguration ist keine Obergrenze für die Gesamtdauer der gesamten Geschäftsaufgabe: Wiederholungen und Wartezeiten erhöhen die Gesamtdauer. Wenn die äußere Ebene die Aufgabe erneut ausführt, sollte zusätzlich eine Gesamt-Deadline und ein Abbruchmechanismus eingerichtet werden.
## Beim eigenen Wiederholungsmechanismus
Deaktiviere die automatischen SDK-Wiederholungen, um Überschneidungen zu vermeiden. Verwende schrittweise steigende Warteintervalle mit zufälligem Jitter; begrenze die Anzahl der Versuche, die maximale Wartezeit und die Parallelität der Warteschlange explizit. Beim Parsen von `Retry-After` beachten, dass der Wert sowohl Sekunden als auch ein HTTP-Datum sein kann.
Wenn dem Nutzer bereits ein Teil des Streaming-Ergebnisses angezeigt wurde, nicht automatisch von vorn abspielen und an den alten Text anhängen. Den Status „unvollständig“ beibehalten und dem Nutzer die Entscheidung über Neugenerierung oder Fortsetzung überlassen.
Bei Bildgenerierung, Tool-Ausführung und anderen Aufgaben, die externe Ergebnisse erzeugen können, besondere Aufmerksamkeit auf doppelte Übermittlungen richten. Es kann nicht davon ausgegangen werden, dass die Einstellung einer beliebigen Anfrage-ID eine automatische Deduplizierung auf Serverseite bewirkt.
## Ausreichend Debugging-Informationen protokollieren
Zeitpunkt, Endpunkt, Modell, Statuscode, Dauer, Versuchsnummer und die vom Server zurückgegebene Anfrage-ID protokollieren. Authentifizierungs-Header und vollständige private Prompts nicht protokollieren. Diese Informationen mit den [Aufrufprotokollen](/de/docs/usage-logs/) abgleichen.
SDK-Einstellungen siehe [OpenAI Python SDK](https://github.com/openai/openai-python#retries) und [Node SDK](https://github.com/openai/openai-node#retries). Konkrete Fehler siehe [Fehlercodes und Debugging](/de/docs/troubleshooting/).
---
# API-Referenz
Source: https://1zheai.com/de/docs/api-reference/
Markdown: https://1zheai.com/de/docs/api-reference.md
---
title: "API-Referenz"
description: "Dokumentierte Schnittstellen, Anfragebeispiele und Protokollunterschiede nachschlagen, um den Kompatibilitätsbereich klar zu bestimmen."
headingIds: {"Schnittstellenindex":"section-1","Kompatibilitätsbereich":"section-2","Antworten und Fehlerbehebung":"section-3"}
---
Hier werden die vorhandenen Schnittstellendokumentationen und Anfragebeispiele dieser Website zusammengefasst. Diese Website bietet Claude- sowie OpenAI-/GPT-Modelle an. Wählen Sie je nach Modell und Tool das entsprechende Protokoll; die konkreten Modelle richten sich nach der in Ihrem Schlüssel verfügbaren Liste.
## Schnittstellenindex
| Schnittstelle | Zweck | Beschreibung und Beispiel |
| --- | --- | --- |
| `POST /v1/messages` | Anthropic-native Konversation | [Anfrage und Antwort](/de/docs/api-messages/), [Anthropic SDK](/de/docs/quickstart-anthropic-sdk/), [curl](/de/docs/quickstart-curl/) |
| `POST /v1/chat/completions` | OpenAI-kompatible Konversation | [Anfrage und Antwort](/de/docs/api-chat-completions/), [OpenAI SDK](/de/docs/quickstart-openai-sdk/), [curl](/de/docs/quickstart-curl/) |
| `POST /v1/responses` | OpenAI Responses | [Anfrage und Antwort](/de/docs/api-responses/), [Codex CLI](/de/docs/quickstart-codex/) |
| `GET /v1/models` | Für den Schlüssel verfügbare Modelle abfragen | [Listenformat und Abfrage](/de/docs/api-models/), [Modellauswahl](/de/docs/models/) |
| `POST /v1/messages/count_tokens` | Eingabe-Token-Zählung | [Schnittstellendokumentation](/de/docs/base-url/) |
| `POST /v1/images/generations` | Text-zu-Bild-Generierung | [Bildgenerierung-Anbindung](/de/docs/api-images/) |
## Kompatibilitätsbereich
Claude-native Funktionen beziehen sich vorrangig auf das Anthropic-Anbindungstutorial. Prüfen Sie vor dem Protokollwechsel, ob die benötigten Funktionen in dem jeweiligen Tutorial beschrieben sind; leiten Sie nicht allein aus einer erfolgreichen Anfrage ab, dass Tool-Aufrufe, Caching oder lange Aufgaben unterstützt werden.
Codex verwendet `/v1/responses`, siehe [Codex-CLI-Anbindung](/de/docs/quickstart-codex/). Die aktuell verfügbaren Modelle ergeben sich aus der [Modellbeschreibung](/de/docs/models/) sowie der Liste, die Ihr Schlüssel tatsächlich zurückgibt.
## Antworten und Fehlerbehebung
Ereignisformat und Behandlung von Verbindungsabbrüchen bei beiden Protokollen. Probleme anhand von Statuscodes und Fehlermeldungen eingrenzen.
Die Schnittstellendetails liefern minimale Anfragen, gebräuchliche Felder, das Lesen von Ergebnissen und Kompatibilitätsgrenzen; vollständige Parameter erfordern weiterhin die Protokolldokumentation des gewählten Modells. Diese Website bietet derzeit keine herunterladbare vollständige OpenAPI-Spezifikation.
Embeddings, Batch, Datei-Hosting und proprietäre Drittanbieter-Modelle, die im öffentlichen Verzeichnis nicht bestätigt sind, fallen nicht unter den Umfang dieser Seite. Fragen Sie bei Bedarf zu diesen Funktionen zuerst beim Support nach.
---
# Base-URL, Schnittstellen und Authentifizierung
Source: https://1zheai.com/de/docs/base-url/
Markdown: https://1zheai.com/de/docs/base-url.md
---
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"}
---
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:
```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
```
- 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.
---
# Modelle über die API abfragen
Source: https://1zheai.com/de/docs/api-models/
Markdown: https://1zheai.com/de/docs/api-models.md
---
title: "Modelle über die API abfragen"
description: "Die beiden Antwortformate von GET /v1/models, das Auslesen der Modell-IDs sowie der Unterschied zwischen Modellsichtbarkeit und tatsächlicher Aufrufbarkeit."
headingIds: {"OpenAI-Format":"section-1","Anthropic-Format":"section-2","Ergebnisse der Abfrage verwenden":"section-3","Liste leer oder Modelle fehlen":"section-4"}
---
Zuerst Modelle abfragen, dann Anfragen schreiben. `GET https://1zheai.com/v1/models` gibt die unter dem aktuellen Schlüssel, der Gruppe und den Modellbeschränkungen sichtbaren Modelle zurück, ohne dass eine Inferenzanfrage gesendet werden muss.
## OpenAI-Format
```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
Nachfolgend eine vereinfachte Strukturübersicht; die Liste richtet sich nach der tatsächlichen Rückgabe:
```json
{
"object": "list",
"data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```
Wenn `jq` installiert ist, kann nach der Anfrage `| jq -r '.data[].id'` angehängt werden, wobei pro Zeile eine Modell-ID angezeigt wird. Verwechseln Sie nicht das `model_name` der öffentlichen Preis-API mit dem `id` hier.
## Anthropic-Format
Bei Verwendung der folgenden beiden Anfrage-Header liefert derselbe Pfad Daten im Anthropic-Stil:
```bash
curl --fail-with-body https://1zheai.com/v1/models \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01"
```
Achten Sie auf `data[].id`, `data[].display_name` und `has_more`. Nach dem Wechsel der Authentifizierungsmethode nicht weiter nach der Antwortstruktur der anderen Methode parsen.
## Ergebnisse der Abfrage verwenden
1. Die vollständige ID aus `data[].id` kopieren und Groß-/Kleinschreibung, Bindestriche und Datums-Suffix beibehalten.
2. Den Schnittstellentyp dieses Modells im [Modellkatalog der Konsole](https://1zheai.com/model-catalog?lng=de) abgleichen.
3. Mit einer minimalen Textanfrage prüfen und schrittweise Bilder, Tools oder weitere Parameter hinzufügen.
Die Modellliste ist keine Echtzeit-Verfügbarkeitsprüfung und enthält nicht alle Parameterbeschränkungen. Ist ein Modell sichtbar, aber derzeit kein verfügbarer Upstream vorhanden, kann die Anfrage dennoch fehlschlagen; das HTTP-Verfügbarkeitsmonitoring auf der offiziellen Website bedeutet nicht, dass jedes Modell erfolgreich inferieren kann.
## Liste leer oder Modelle fehlen
Modellbeschränkung und Gruppe des Schlüssels prüfen; die auf der öffentlichen Preis-Seite angezeigten Modelle sind nicht unbedingt für jeden Schlüssel freigeschaltet. Bei 401 zuerst den Schlüsselstatus prüfen, bei 403 die Zugriffsbedingungen; ausführliche Schritte unter [Fehlercodes und Fehlersuche](/de/docs/troubleshooting/).
Modellreihen und Auswahlhinweise unter [Unterstützte Modelle](/de/docs/models/).
---
# Chat Completions-Dialogschnittstelle
Source: https://1zheai.com/de/docs/api-chat-completions/
Markdown: https://1zheai.com/de/docs/api-chat-completions.md
---
title: "Chat Completions-Dialogschnittstelle"
description: "Minimalanfrage, gebräuchliche Felder, Antwortauslesen und Mehrrunden-Dialoge für POST /v1/chat/completions."
headingIds: {"Minimalanfrage":"section-1","Gebräuchliche Felder":"section-2","So lesen Sie die Antwort aus":"section-3","Mehrrunden-Dialog":"section-4","Streaming und nächste Schritte":"section-5"}
---
Verwenden Sie einen OpenAI-kompatiblen Client oder beginnen Sie mit dieser Schnittstelle, wenn Sie bereits über `chat.completions.create`-Code verfügen. Die vollständige Adresse lautet `https://1zheai.com/v1/chat/completions`; die Base URL des SDK wird nur bis zu `/v1` eingetragen.
## Minimalanfrage
Legen Sie im Terminal zuerst `ONEZHE_API_KEY` auf den Schlüssel dieser Website fest. Das folgende Modell muss in [Ihrer verfügbaren Modellliste](/de/docs/api-models/) vorhanden sein.
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "请用一句中文解释 DNS 的作用。"}]
}'
```
`--fail-with-body` sorgt dafür, dass HTTP-Fehler einen Nicht-Null-Exitcode zurückgeben und gleichzeitig den Fehlertext erhalten bleiben; erfordert curl 7.76 oder neuer. Bei älteren Versionen können Sie zuerst mit `-i` den Statuscode anzeigen.
## Gebräuchliche Felder
| Feld | Typ | Verwendung |
| --- | --- | --- |
| `model` | string | Erforderlich, Modell-ID dieser Website kopieren, keine Anbieterpräfixe anderer Plattformen hinzufügen |
| `messages` | array | Erforderlich, sendet die Frage dieser Runde und die zu behaltenden Verlaufsnachrichten in Reihenfolge |
| `messages[].role` | string | Für normale Dialoge `user` / `assistant` verwenden; die Unterstützung der Rolle für Systemanweisungen hängt vom Modell ab |
| `messages[].content` | string oder Array von Inhaltblöcken | Für reinen Text zuerst eine Zeichenkette verwenden; Bildeingaben erfordern die entsprechenden Inhaltsblöcke vom Modell unterstützt |
| `stream` | boolean | Wenn auf `true` gesetzt, wird SSE gelesen und die gesamte Antwort nicht mehr als ein JSON behandelt |
| `temperature` | number | Optional, einige Reasoning-Modelle unterstützen keine Änderung; zuerst weglassen und dann einzeln prüfen |
| `tools` / `tool_choice` | array / string oder object | Optional, sowohl Modell als auch Upstream müssen es unterstützen; die tatsächliche Ausführung der Tools erfolgt durch Ihr Programm |
Die Obergrenze für die Ausgabe variiert je nach Modell. Tauschen Sie Claude's `max_tokens`, Responses' `max_output_tokens` und die Parameter von Chat Completions nicht mechanisch aus; beziehen Sie sich auf die Anforderungen des gewählten Modells und sehen Sie bei einem 400 zuerst im Fehlertext nach.
## So lesen Sie die Antwort aus
Das normale Textergebnis befindet sich in `choices[0].message.content`. Der Beendigungsgrund steht in `choices[0].finish_reason`; bei Rückgabe eines Tool-Aufrufs kann der Text leer sein, dann muss `message.tool_calls` gelesen werden. Die `id`, `model` und `usage` der Antwort können zur Überprüfung dieses Aufrufs verwendet werden.
Nachfolgend wird nur die Struktur gezeigt, auf die Sie achten müssen; weggelassene Felder und Zahlen entsprechen nicht dem tatsächlichen Anfrageergebnis:
```json
{
"id": "example-completion",
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "DNS 将域名解析为网络地址。"},
"finish_reason": "stop"
}]
}
```
## Mehrrunden-Dialog
Die Schnittstelle erinnert sich nicht automatisch an die vorherige Runde, nur weil Sie denselben Schlüssel erneut verwenden. Senden Sie den zu behaltenden Verlauf gemeinsam mit:
```json
{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "我正在学习 DNS。"},
{"role": "assistant", "content": "我们可以从域名解析开始。"},
{"role": "user", "content": "它和 HTTP 有什么区别？"}
]
}
```
Je länger der Verlauf, desto größer die Anfrage. Die Anwendung sollte gemäß den Kontextbeschränkungen kürzen oder zusammenfassen und die vollständigen Tool-Aufrufe mit den zugehörigen Ergebnissen paarweise erhalten.
## Streaming und nächste Schritte
Nach Hinzufügen von `"stream": true` stammen die Textinkremente aus `choices[].delta.content`. Einige Ereignisse enthalten keinen Text oder `choices` ist leer; dies muss beim Lesen berücksichtigt werden; siehe [Streaming-Ausgabe](/de/docs/streaming/).
Führen Sie direkt [Python-/Node.js-Vollbeispiel](/de/docs/code-examples/) aus oder wechseln Sie zu [Responses](/de/docs/api-responses/); Claude-native Parameter finden Sie unter [Messages](/de/docs/api-messages/).
---
# Messages Native-Konversations-API
Source: https://1zheai.com/de/docs/api-messages/
Markdown: https://1zheai.com/de/docs/api-messages.md
---
title: "Messages Native-Konversations-API"
description: "Request-Header von Claude Messages, Unterschiede zwischen system und messages, Inhaltsblöcke und Beendigungsgründe."
headingIds: {"Minimale Anfrage":"section-1","Anfragestruktur":"section-2","Inhaltsblöcke lesen":"section-3","Mehrere Runden und Streaming":"section-4"}
---
Claude Code, Anthropic SDK und Anwendungen, die Claude-native Inhaltsblöcke beibehalten möchten, verwenden `POST https://1zheai.com/v1/messages`. SDK Base URL: `https://1zheai.com`.
## Minimale Anfrage
Zuerst die Umgebungsvariable für den Site-Schlüssel `ONEZHE_API_KEY` setzen, dann ausführen:
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": "请用简短的中文回答。",
"messages": [{"role": "user", "content": "什么是域名解析？"}]
}'
```
## Anfragestruktur
| Feld | Typ | Verwendung |
| --- | --- | --- |
| `model` | string | Erforderlich, wählt das Claude-Modell, für das der Schlüssel verfügbar ist |
| `max_tokens` | integer | Erforderlich, Ausgabegrenze; in Kombination mit den Limit-Einstellungen des gewählten Modells |
| `messages` | array | Erforderlich, sendet `user`- und `assistant`-Nachrichten in chronologischer Reihenfolge |
| `system` | string oder Array von Inhaltsblöcken | Optional, Systemanweisung auf oberster Ebene, keine `role: system`-Nachricht verwenden |
| `stream` | boolean | Optional, Inhaltsblock-Inkremente streamen |
| `tools` | array | Optional, deklariert Werkzeugnamen, Zweck und Eingabe-Schema |
`thinking`, Cache-Steuerung und Beta-Parameter hängen vom jeweiligen Modell und der Upstream-Unterstützung ab. Zuerst Klartext testen, dann nach Bedarf hinzufügen; nicht alle Modelle als eine Parametergruppe behandeln.
## Inhaltsblöcke lesen
Das zurückgegebene `content` ist ein Array und kann gleichzeitig Text, Werkzeuganfragen oder andere Inhaltsblöcke enthalten. `content[0].text` nicht bedingungslos lesen. Beispiel mit dem Anthropic Python SDK:
```python
for block in message.content:
if block.type == "text":
print(block.text)
```
Hier stammt `message` aus dem `client.messages.create(...)` im [Anthropic SDK-Tutorial](/de/docs/quickstart-anthropic-sdk/).
| `stop_reason` | Verarbeitung durch die Anwendung |
| --- | --- |
| `end_turn` | Diese Antwortrunde ist beendet |
| `max_tokens` | Ausgabe wurde durch die Grenze abgeschnitten und darf nicht als vollständige Antwort behandelt werden |
| `tool_use` | Werkzeuganfragen prüfen, erlaubte Werkzeuge ausführen und Ergebnisse zurücksenden |
| Andere Werte | Antwort bewahren und gemäß dem Protokoll des gewählten Modells verarbeiten, nicht davon ausgehen, dass es sich immer um einen Textabschluss handelt |
Im Werkzeugaufruf-Loop zuerst den vollständigen assistant-Inhaltsblock zur Historie hinzufügen, dann über `tool_result` im user-Inhalt zurücksenden; `tool_use_id` muss der Originalanfrage entsprechen. Werkzeuganfragen nicht direkt in einen einfachen Textabsatz umwandeln.
## Mehrere Runden und Streaming
Bei jeder Anfrage die erforderliche Historie mitsenden; die API selbst speichert den Dialog nicht für die Anwendung. Streaming kennzeichnet das Nachrichtenende mit `message_stop`; der Empfang von Teiltext bedeutet nicht, dass die Anfrage abgeschlossen ist. Siehe [Streaming-Ausgabe](/de/docs/streaming/).
Protokolldetails: [Anthropic Messages-Nutzungsanleitung](https://platform.claude.com/docs/en/build-with-claude/working-with-messages). Ob erweiterte Parameter dieser Site verfügbar sind, richtet sich nach dem Modellkatalog und der tatsächlichen Antwort.
---
# Responses-Schnittstelle
Source: https://1zheai.com/de/docs/api-responses/
Markdown: https://1zheai.com/de/docs/api-responses.md
---
title: "Responses-Schnittstelle"
description: "Verbinde dich über die OpenAI Responses-Schnittstelle mit 1折AI und verstehe Input, Output, Streaming-Ereignisse und Kompatibilitätsgrenzen."
headingIds: {"Minimalanfrage":"section-1","Unterschiede zu Chat Completions":"section-2","Python SDK":"section-3","Streaming-Lesen":"section-4","Kompatibilitätsbereich":"section-5"}
---
Codex CLI verwendet das Responses-Protokoll. Wenn du eigene Anwendungen schreibst, kannst du über `POST https://1zheai.com/v1/responses` GPT-Modelle anfragen, die diese Schnittstelle unterstützen. Die Base URL des OpenAI SDK wird mit `https://1zheai.com/v1` ausgefüllt.
## Minimalanfrage
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/responses \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"input": "用三句话解释 API 网关。",
"store": false
}'
```
Vor dem Ausführen `ONEZHE_API_KEY` setzen und sicherstellen, dass das Modell in [deiner verfügbaren Liste](/de/docs/api-models/) enthalten ist. `store: false` ist eine Speicheroption im Protokoll und bedeutet nicht, dass auf allen Serviceebenen keine Protokollierung oder Datenaufbewahrung stattfindet; leite daraus keine Datenschutzversprechen ab.
## Unterschiede zu Chat Completions
| Inhalt | Chat Completions | Responses |
| --- | --- | --- |
| Eingabe | `messages` | `input`, kann ein String oder strukturierte Eingabeelemente sein |
| Textergebnis | `choices[].message.content` | Message-Inhaltsblock in `output` |
| SDK-Text-Hilfsattribute | choice selbst extrahieren | `response.output_text` |
| Streaming-Text | `choices[].delta.content` | `response.output_text.delta`-Ereignisse |
| Ende-Bestimmung | `finish_reason` und Stream-Ende | Antwortstatus und Beendigungsereignis prüfen |
`output_text` ist ein vom SDK bereitgestelltes Komfortattribut; gehe nicht davon aus, dass dieses Feld auf oberster Ebene der rohen HTTP-JSON existiert. Bei direktem HTTP-Aufruf über `output` iterieren, `type: message` auswählen und dann dessen `content` mit `type: output_text` aus `text` lesen.
## Python SDK
Nach der Installation von `python -m pip install openai`:
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
response = client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
)
print(response.output_text)
print("status:", response.status)
```
Hier wird automatisches Wiederholen deaktiviert, um die erste Integration bei einer einzelnen Anfrage zu erleichtern. Vor dem Produktivbetrieb die Strategie gemäß [Timeout und Wiederholen](/de/docs/retries/) einstellen.
## Streaming-Lesen
Nach dem oben initialisierten `client` verwenden:
```python
with client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
stream=True,
) as stream:
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
print("\n完成")
elif event.type in {"response.failed", "response.incomplete", "error"}:
raise RuntimeError(f"响应未完成：{event.type}")
```
Wenn die Verbindung getrennt wird, ohne ein Abschlusseignis zu empfangen, sollte das Ergebnis als unvollständig markiert werden; Erfolg darf nicht allein anhand des bereits ausgegebenen Texts beurteilt werden.
## Kompatibilitätsbereich
Diese Seite behandelt das Erstellen von Antworten und das Lesen von Text. Leite daraus nicht ab, dass alle Fähigkeiten wie Hintergrundaufträge, Abruf früherer Antworten, `previous_response_id`, verwaltete Tools, Dateispeicherung usw. verfügbar sind. Wenn eine Sitzungsfortsetzung erforderlich ist, zuerst mit expliziter Verlaufseingabe verifizieren; bei bestimmten Tools je Modell und Client einzeln verifizieren.
Für die Konfiguration fertiger Tools siehe [Codex CLI](/de/docs/quickstart-codex/). SDK-Verwendung siehe [OpenAI Python SDK](https://github.com/openai/openai-python).
---
# Bildgenerierung einbinden
Source: https://1zheai.com/de/docs/api-images/
Markdown: https://1zheai.com/de/docs/api-images.md
---
title: "Bildgenerierung einbinden"
description: "Bilder über die OpenAI Images-Schnittstelle generieren, das Base64-Ergebnis speichern und Modellberechtigungen sowie Zeitüberschreitungen überprüfen."
headingIds: {"Schnittstelle und Vorbereitung":"section-1","Ein Bild generieren und speichern":"section-2","Vor Hinzufügen von Parametern die Modellunterstützung prüfen":"section-3","Häufige Probleme":"section-4"}
---
Das öffentliche Modellverzeichnis dieser Website listet derzeit `gpt-image-1.5` und `chatgpt-image-latest` (geprüft am 2026-10-16). Vor der Verwendung zuerst die [verfügbaren Modelle für den Schlüssel](/de/docs/api-models/) abfragen und dann im [Konsolen-Modellverzeichnis](https://1zheai.com/model-catalog?lng=de) die Bildschnittstelle und Parameter bestätigen.
Diese Seite bietet Einbindungsbeispiele gemäß dem OpenAI Images-Protokoll; bei diesem Dokumentationsupdate wurde keine kostenpflichtige Bildgenerierung ausgeführt, daher dürfen die folgenden Beispiele nicht als getestet für alle Modell-, Größen- und Qualitätskombinationen angesehen werden.
## Schnittstelle und Vorbereitung
- Vollständige Adresse: `POST https://1zheai.com/v1/images/generations`
- OpenAI SDK Base URL: `https://1zheai.com/v1`
- Die Umgebungsvariable `ONEZHE_API_KEY` dieser Website verwenden.
- Python SDK installieren: `python -m pip install openai`.
## Ein Bild generieren und speichern
Speichern als `generate-image.py`, im Terminal ausführen `python generate-image.py`:
```python
import base64
import os
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=300.0,
max_retries=0,
)
result = client.images.generate(
model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
target = Path("generated-image.png")
target.write_bytes(base64.b64decode(item.b64_json, validate=True))
print(f"图片已保存到 {target.resolve()}")
elif item.url:
print("返回的是图片地址，请及时下载：", item.url)
else:
raise RuntimeError("响应没有 b64_json 或 url。")
```
Das Beispiel verwendet das Standard-Ausgabeformat. Wenn ein anderes Format wie JPEG / WebP angegeben wird, muss auch die Dateiendung beim Speichern entsprechend geändert werden. Den Base64-String nicht direkt als Textdatei schreiben und dann in PNG umbenennen.
## Vor Hinzufügen von Parametern die Modellunterstützung prüfen
Zuerst mit einer Anfrage nur mit `model` und `prompt` verifizieren. Parameter wie Größe, Qualität, transparenter Hintergrund und Ausgabeformat sind nicht bei allen Bildmodellen allgemein gültig; Modellnamen oder proprietäre Parameter anderer Anbieter nicht direkt kopieren.
Bei Rückgabe von `data[].b64_json` Base64 dekodieren; bei Rückgabe von `data[].url` rechtzeitig herunterladen und die temporäre URL nicht als dauerhafte Speicherung behandeln. Die Anwendung muss die Ergebnisspeicherung selbst organisieren.
## Häufige Probleme
| Situation | Überprüfungsmethode |
| --- | --- |
| 400 Parameter nicht unterstützt | Benutzerdefinierte Größe, Qualität usw. entfernen und dann schrittweise prüfen |
| 403 / 404 | Bildmodell-ID, Schlüsselberechtigungen und vollständigen Schnittstellenpfad prüfen |
| Lange Wartezeit | Für die Generierung eine angemessene Zeitüberschreitung einrichten und einen Fortschrittsstatus anzeigen, um durch wiederholtes Klicken doppelte Einreichungen zu vermeiden |
| Kein Bild nach Zeitüberschreitung | Zuerst die Aufrufprotokolle einsehen; kein erhaltenes Ergebnis bedeutet nicht, dass die Upstream-Seite die Anfrage nicht verarbeitet hat |
| Vorhandenes Bild bearbeiten | Bildbearbeitung ist eine andere Schnittstelle und Eingabemethode, das Text-zu-Bild-Beispiel dieser Seite kann nicht direkt ersetzen |
Protokollparameter-Referenz [OpenAI Bildgenerierungsreferenz](https://developers.openai.com/api/reference/resources/images/methods/generate). Die Kosten richten sich nach dem Echtzeit-Modellverzeichnis dieser Website; Wiederholungsstrategie siehe [Zeitüberschreitung und Wiederholung](/de/docs/retries/).
---
# Konto und Support
Source: https://1zheai.com/de/docs/support/
Markdown: https://1zheai.com/de/docs/support.md
---
title: "Konto und Support"
description: "Gebühren und Aufrufprotokolle verwalten, Zugangsprobleme lokalisieren und die erforderlichen Fehlerdiagnoseinformationen bereitstellen."
headingIds: {"Shop-Bestellungen":"section-1","Gebühren und Konto":"section-2","Probleme bei Aufrufen":"section-3","Selbsthilfe-Nachschlagen":"section-4"}
---
## Shop-Bestellungen
[Kaufanleitung](/de/docs/store-guide/) · [Bestellungsprobleme](/de/docs/store-orders/) · [Transaktions- und Nachkauf-Regeln](/de/docs/store-rules/)
Bei Problemen mit einsatzbereiten Konten, Aufladungen und Geschenkkarten prüfen Sie bitte zuerst den Status unter [Meine Bestellungen](https://1zheai.com/store-orders?lng=de); geben Sie beim Kontaktieren des Supports die Bestellnummer und die geschwärzten Fehlerinformationen an und senden Sie keine Passwörter, Bestätigungscodes oder vollständigen Sitzungsdaten.
## Gebühren und Konto
Erfahren Sie mehr über die Gebührenstruktur und Berechnungserklärungen.Abfragen Sie die Zahlungs- und Nachkauf-Regeln.Lokalisieren Sie jeden Aufruf und gleichen Sie die Gebühren ab.Sehen Sie die Anweisungen zum Erstellen, Speichern und Rotieren an.
## Probleme bei Aufrufen
Sehen Sie sich zuerst die [Fehlercodes und Fehlerdiagnose](/de/docs/troubleshooting/) an und prüfen Sie dann die [Adresse und das Protokoll](/de/docs/base-url/) sowie die [Tool-Einschränkungen](/de/docs/integrations/). Die Methode zur Überprüfung von Modell und Verbrauch finden Sie unter [Modell und Verbrauch überprüfen](/de/docs/verify-model/).
Wenn Sie weiterhin Hilfe benötigen, geben Sie über die im Konsole oder auf der offiziellen Website veröffentlichten Supportkanäle an: Zeitpunkt und Zeitzone des Auftretens, Tool und Version, Modell-ID, HTTP-Statuscode, Anfrage-ID (falls vorhanden), geschwärzte Fehlerinformationen und ob das Problem mit einer minimalen Anfrage reproduziert werden kann.
Senden Sie keine vollständigen API-Schlüssel, Authentifizierungs-Header oder vollständige Konversationen mit privaten Inhalten.
## Selbsthilfe-Nachschlagen
- [Häufige Zugangsfragen](/de/docs/faq/): Adressen, Modelle, das Lesen von Antworten und die Bedeutung von Monitoring.
- [Zeitüberschreitungen und Wiederholungen](/de/docs/retries/): Einstellen der Client-Wartezeit und des Fehlerverhaltens.
- [Migrationsanleitung](/de/docs/migration/): Schrittweiser Umstieg vom ursprünglichen Anbieter.
---
# Preise und Abrechnung
Source: https://1zheai.com/de/docs/pricing-explained/
Markdown: https://1zheai.com/de/docs/pricing-explained.md
---
title: "Preise und Abrechnung"
description: "Claude-Eingaben und -Ausgaben werden mit Rabatt je Modell abgerechnet, Cache-Lese- und Cache-Schreibvorgänge zum offiziellen Originalpreis; prüfen Sie die Aufrufkosten anhand der Abrechnungsbeispiele."
headingIds: {"Was pro Aufruf abgerechnet wird":"section-1","Rechenbeispiel":"section-2","Abrechnung des Systemprompts":"section-3","Guthaben und Währung":"section-4","So prüfen Sie Rabatte und Kosten":"section-5","Häufige Fragen":"section-6"}
---
**Claude-Eingaben und -Ausgaben werden mit dem Rabatt dieses Modells abgerechnet, Cache-Lesen und Cache-Schreiben zum offiziellen Originalpreis, ohne Rabatt.** Die Einzelpreise und Rabatte jedes Modells finden Sie unter[Modelle und Preise](https://1zheai.com/en/pricing/). Für GPT, MiMo und Bildgenerierungsmodelle sehen Sie bitte die jeweiligen Abrechnungseinheiten und Angebote an; die Token-Beispiele auf dieser Seite gelten für Claude.
## Was pro Aufruf abgerechnet wird
Jeder Aufruf wird nach den vier Token-Arten in der Antwort `usage` separat abgerechnet:
```text
费用 = ( 输入 token × 输入单价
+ 缓存写入 token × 缓存写单价
+ 缓存读取 token × 缓存读单价
+ 输出 token × 输出单价 ) ÷ 1,000,000
输入单价、输出单价 = 对应官方单价 × 该模型折扣
缓存读取单价、缓存写入单价 = 对应官方原价
```
Die vier Token-Arten entsprechen diesen Feldern in der Antwort:
| Abrechnungsposition | `usage`-Feld (nativ bei Anthropic) | Offizieller Einzelpreis relativ zum Eingabepreis |
|---|---|---|
| Eingabe | `input_tokens` | 1× |
| Cache-Schreiben | `cache_creation_input_tokens` | 1,25× (5-Minuten-Cache), 2× (1-Stunden-Cache, `"ttl": "1h"`) |
| Cache-Lesen | `cache_read_input_tokens` | 0,1× (Opus 5.5 und Sonnet 5.5 0,05×, Fable 5.1 0,025×) |
| Ausgabe | `output_tokens` | je Modell, siehe Preisseite |
Die offiziellen Cache-Multiplikatoren stammen aus der [Anthropic-Prompt-Caching-Dokumentation](https://platform.claude.com/docs/en/build-with-claude/prompt-caching). Die Cache-Vorgänge auf dieser Seite werden zum jeweiligen offiziellen Originalpreis abgerechnet und nicht mit dem Eingabe-/Ausgaberabatt multipliziert.
Die Schreib-Token des 1-Stunden-Caches werden separat unter `cache_creation.ephemeral_1h_input_tokens` erfasst und mit dem 2-fachen des offiziellen Eingabepreises abgerechnet, ohne Multiplikation mit dem Eingabe-/Ausgaberabatt. Die auf der Preisseite aufgeführten Cache-Schreib-Einzelpreise gelten für den 5-Minuten-Cache.
## Rechenbeispiel
Die folgenden Einzelpreise sind zur Demonstration willkürlich gewählte ganze Zahlen und entsprechen keinem konkreten Modell; die tatsächlichen Einzelpreise finden Sie auf der Preisseite.
Angenommen, ein Modell hat folgende offizielle Einzelpreise (pro Million Token): Eingabe $3, Ausgabe $15, Cache-Schreiben $3,75, Cache-Lesen $0,30. Die `usage` einer Claude-Code-Anfrage lautet:
```json
{
"input_tokens": 2000,
"cache_creation_input_tokens": 1500,
"cache_read_input_tokens": 30000,
"output_tokens": 800
}
```
Nach offiziellen Preisen:
| Position | Token | Offizieller Einzelpreis | Offizielle Kosten |
|---|---|---|---|
| Eingabe | 2.000 | $3 | $0,006 |
| Cache-Schreiben | 1.500 | $3,75 | $0,005625 |
| Cache-Lesen | 30.000 | $0,30 | $0,009 |
| Ausgabe | 800 | $15 | $0,012 |
| Summe | | | $0,032625 |
Angenommen, Eingabe und Ausgabe dieses Beispielmodells betragen 20 % des offiziellen Preises (nur für das Rechenbeispiel, repräsentiert nicht die aktuellen Modellpreise), dann:
```text
输入费用 = $0.006 × 0.2 = $0.0012
输出费用 = $0.012 × 0.2 = $0.0024
缓存费用 = $0.005625 + $0.009 = $0.014625
合计 = $0.018225
```
Die offiziellen Gesamtkosten dürfen nicht direkt mit dem Eingabe-/Ausgaberabatt multipliziert werden, da der Cache-Anteil nicht rabattiert wird.
Wenn derselbe Aufruf den Cache nicht trifft, werden die 30.000 Token zum rabattierten Eingabepreis dieses Modells berechnet. Ob Kosten gespart werden, muss anhand von Modellrabatt, Cache-Schreibkosten und Anzahl der Wiederlesevorgänge verglichen werden; ein Vergleich nur der offiziellen Preise genügt nicht. Konfigurations- und Prüfmethode siehe [Prompt Caching](/de/docs/prompt-caching/).
## Abrechnung des Systemprompts
Die Claude-API stammt aus einem Pool offizieller Abonnementkonten. Aufrufe über Claude Code enthalten keine zusätzlichen Inhalte. Andere Clients (SDK, curl und Drittanbieter-Tools) hängen jeder Anfrage einen Systemprompt an, der als Eingabe-Token abgerechnet wird: bei Sonnet 4.6 etwa 350 Token, bei der 5.x-Serie etwa 500 Token. Dieser Anteil wird zusammen mit Ihren eigenen Inhalten in `usage` der Antwort in `input_tokens` erfasst.
Gemessener Test am 2026-10-15 mit curl und der Anfrage „Reply with just: ok“:
| Modell | `count_tokens`-Zählung | Tatsächliches `input_tokens` | Angehängter Systemprompt (ca.) |
|---|---|---|---|
| Sonnet 4.6 | 19 | 370 | 350 Token |
| 5.x-Serie | 18–19 | 510–530 | etwa 500 Token |
- `count_tokens` zählt nur Ihre gesendeten Inhalte und enthält diesen Systemprompt nicht. Schätzen Sie die Kosten mit SDK, curl oder Drittanbieter-Tools, addieren Sie die Zahlen aus der obigen Tabelle; bei Claude Code ist das nicht nötig.
- Die im Aufrufprotokoll erfassten Eingabe-Token enthalten diesen Anteil bereits; eine Nachrechnung nach der obigen Formel ergibt ein Ergebnis, das mit der Abrechnung im Protokoll übereinstimmt.
- Je kürzer die Anfrage, desto höher der Anteil; bei langen Kontextanfragen ist er sehr gering.
## Guthaben und Währung
- Die Abrechnung erfolgt nach dem oben genannten USD-Verfahren und wird von Ihrem Kontoguthaben abgezogen. Das Guthaben wird in USD geführt.
- Aufladebeträge werden in USD gutgeschrieben; die Zahlungsabwicklungsgebühr wird separat ausgewiesen und ist nicht erstattungsfähig; verfügbare Zahlungsmittel und Betragslimits gelten laut Bestellseite der Wallet.
## So prüfen Sie Rabatte und Kosten
Prüfen Sie zuerst den Eingabe-/Ausgaberabatt des jeweiligen Modells und berechnen Sie dann Eingabe, Ausgabe, Cache-Lesen und Cache-Schreiben getrennt. Jede Abbuchung kann im[Aufrufprotokoll](/de/docs/usage-logs/) anhand des jeweiligen Einzelpreises nachgerechnet werden.
## Häufige Fragen
Der häufigste Grund ist ein verfehlter Cache: zu langer Zeitraum zwischen zwei Anfragen (Standard-Cache 5 Minuten), eine geänderte vordere Kontexthälfte oder ein Modellwechsel. Öffnen Sie das Aufrufprotokoll und vergleichen Sie die Cache-Lese-Token beider Vorgänge.
Nein. Cache-Lesen und Cache-Schreiben werden zum offiziellen Originalpreis abgerechnet, Eingabe und Ausgabe mit dem Rabatt des jeweiligen Modells.
Aufrufe über Claude Code enthalten keine zusätzlichen Inhalte. Andere Clients (SDK, curl und Drittanbieter-Tools) hängen jeder Anfrage einen Systemprompt an, der als Eingabe-Token abgerechnet wird: bei Sonnet 4.6 etwa 350 Token, bei der 5.x-Serie etwa 500 Token. Gemessene Daten siehe[Abrechnung des Systemprompts](#section-3).
Finden Sie den Vorgang im Aufrufprotokoll, setzen Sie die Zahlen der vier Token-Arten und die Einzelpreise der Preisseite in die obige Formel ein; das Ergebnis sollte mit der Abrechnung im Protokoll übereinstimmen. Falls nicht, senden Sie uns Zeitpunkt und Modell dieses Protokolleintrags.
---
# Nutzungsprotokoll und Abrechnung
Source: https://1zheai.com/de/docs/usage-logs/
Markdown: https://1zheai.com/de/docs/usage-logs.md
---
title: "Nutzungsprotokoll und Abrechnung"
description: "In den Aufrufprotokollen der 1折AI Konsole jedes Modell, die vier Token-Arten und die Gebühren einsehen und eine Abrechnung nach Formel nachrechnen."
headingIds: {"Wo nachsehen":"section-1","Was jedes Protokoll enthält":"section-2","Eine Abrechnung prüfen":"section-3","Cache-Wirkung anhand der Protokolle beobachten":"section-4","Abweichungen von der eigenen Statistik":"section-5"}
---
Jeder Aufruf hinterlässt eine Detailzeile im Aufrufprotokoll. Diese Seite erklärt, wie man sie liest und wie man eine Abrechnung prüft.
## Wo nachsehen
[Die Konsole](https://1zheai.com/console?lng=de) linke Menüleiste → "Aufrufprotokolle" (Adresse `https://1zheai.com/usage-logs`), Seitentitel ist "Allgemeine Protokolle".
Oben lässt sich nach Zeitraum filtern, nach Klick auf "Erweitern" zusätzlich nach Modellname, API-Schlüsselname ("Token-Name"), Anfrage-ID und Protokolltyp. Nach dem Filtern auf "Suchen" klicken; "Exportieren" lädt die aktuellen Filterergebnisse herunter, um sie in einer Tabelle abzugleichen.
## Was jedes Protokoll enthält
| Spalte | Inhalt |
|---|---|
| Zeit | Zeitpunkt der Anfrage |
| Token | Name des bei diesem Aufruf verwendeten API-Schlüssels |
| Modell | Tatsächlich aufgerufene Modell-ID |
| Stream | "Stream" oder "Non-Stream" sowie Ausgabegeschwindigkeit (t/s) |
| Token | Erste Zeile ist "Eingabe / Ausgabe"-Token; bei Cache erscheint darunter eine weitere Zeile, nach "Cache↓" folgen Cache-Lese-Token, nach "↑" Cache-Schreib-Token |
| Gebühr | In USD berechneter Betrag für diesen Aufruf |
| Dauer | Gesamtdauer; bei Streaming-Anfragen wird zusätzlich die Zeit bis zum ersten Zeichen angezeigt |
| Details | Einzelpreise und weitere Details dieses Aufrufs |
Vom Gateway abgelehnte Anfragen (ungültiger API-Schlüssel, unzureichender Saldo, falsch geschriebenes Modell usw.) werden nicht berechnet. Anfragen, bei denen der Upstream einen Fehler zurückgibt, kosten 0. Wird eine Streaming-Anfrage unterbrochen, ist sie nicht vollständig kostenlos, siehe [Streaming-Ausgabe](/de/docs/streaming/).
## Eine Abrechnung prüfen
Nach Zeit und Modell die zu prüfende Zeile finden und die vier Werte aus der Token-Spalte notieren: Eingabe, Ausgabe, Cache-Lese (Cache↓) und Cache-Schreib (↑).
Auf der [Preisseite](https://1zheai.com/en/pricing/) die Einzelpreise für Eingabe, Ausgabe, Cache-Lese und Cache-Schreib des Modells finden (Eingabe und Ausgabe sind bereits mit dem Modellrabatt berechnet, Cache zum offiziellen Originalpreis).
```text
扣费 = ( 输入 × 输入单价
+ 缓存写入 × 缓存写单价
+ 缓存读取 × 缓存读单价
+ 输出 × 输出单价 ) ÷ 1,000,000
```
Das Ergebnis sollte mit der Gebühr im Protokoll übereinstimmen. Rundung kann Unterschiede in der letzten Stelle verursachen.
Bei Abweichungen Zeit, Modell und Screenshot dieser Protokollzeile an uns senden.
## Cache-Wirkung anhand der Protokolle beobachten
In Werkzeugen wie Claude Code sollte der größte Teil der Eingaben in der Spalte "Cache-Lesen" landen. Wenn mehrere aufeinanderfolgende Einträge überwiegend "Cache-Schreiben" zeigen und "Cache-Lesen" selten ist, wird der Cache nicht wiederverwendet. Ursachen und Lösungen siehe [Prompt Caching](/de/docs/prompt-caching/).
Eine grobe Trefferquote: Cache-Lesen ÷ (Eingabe + Cache-Schreiben + Cache-Lesen).
## Abweichungen von der eigenen Statistik
- Claude Code verwendet für einige Hintergrundkleinaufgaben Modelle der Haiku-Klasse, daher erscheinen im Protokoll Modelle, die man nicht selbst ausgewählt hat. Siehe Modellzuordnung in [Claude Code-Anbindung](/de/docs/quickstart-claude-code/).
- Die Eingabe-Token im Protokoll übersteigen den gesendeten Inhalt um einige hundert: Bei Aufrufen über SDK, curl oder Drittanbieter-Tools wird jeder Anfrage ein Systemprompt angehängt und als Eingabe berechnet (Claude Code hängt keinen an), siehe [Abrechnung des Systemprompts](/de/docs/pricing-explained/#section-3).
- Ein "Gespräch" in einem Werkzeug kann vielen API-Aufrufen entsprechen (eine Runde pro Werkzeugaufruf); die Protokolle werden pro API-Aufruf erfasst.
---
# Aufladung, Rückerstattung und Rechnungen
Source: https://1zheai.com/de/docs/billing/
Markdown: https://1zheai.com/de/docs/billing.md
---
title: "Aufladung, Rückerstattung und Rechnungen"
description: "Wie man bei 1zheai auflädt, Mindestbetrag, unterstützte Zahlungsmethoden, Rückerstattungsregeln für ungenutztes Guthaben innerhalb von 7 Tagen und welche Rechnungen für welche Zahlungsmethoden ausgestellt werden können."
headingIds: {"Aufladung":"section-1","API-Guthaben-Rückerstattung":"section-2","Rechnungen":"section-3","Häufige Fragen":"section-4"}
---
Diese Seite erklärt das API-Kontoguthaben: Zuerst aufladen, dann wird bei jedem Aufruf nach Verbrauch abgebucht. AI-Kontenprodukte werden nach den Produktspezifikationen gekauft, den Service nach dem Kauf siehe [Konten-Marktplatz](https://1zheai.com/en/store/), die Rückerstattungsregeln für API-Guthaben auf dieser Seite gelten nicht dafür.
Die Rückerstattungsregeln für Guthaben auf dieser Seite gelten für Modell-API-Aufladungen. Für einsatzbereite Konten, Aufladung durch Dritte und Geschenkkarten-Bestellungen siehe [Marktplatz-Handels- und Service-Regeln](/de/docs/store-rules/), die 7-Tage-Regel der API gilt hier nicht unmittelbar.
## Aufladung
| Punkt | Erläuterung |
|---|---|
| Betragsbeschränkung | Maßgeblich ist die Bestellseite der Wallet |
| Zahlungsmethoden | WeChat Pay, Alipay, Stripe (Bankkarte), USDT |
| Zugang | [Konsole](https://1zheai.com/console?lng=de) Menü links „Wallet“ → „Guthaben hinzufügen“ |
| Wie abgebucht wird | Claude Ein-/Ausgabe nach Modellrabatt, Cache zum offiziellen Originalpreis; andere Modelle nach dem jeweiligen Preis, siehe [Preise und Abrechnung](/de/docs/pricing-explained/) |
Das aufgeladene Kapital wird in USD verbucht, die Zahlungsabwicklungsgebühr wird separat ausgewiesen und nicht erstattet.
## API-Guthaben-Rückerstattung
**Innerhalb von 7 Tagen nach der Aufladung kann das ungenutzte Kapital auf demselben Weg zurückgefordert werden. Bereits verbrauchte Teile und die Zahlungsabwicklungsgebühr werden nicht erstattet.**
Siehe im Aufrufprotokoll den Verbrauch nach dieser Aufladung, maßgeblich ist das erstattungsfähige ungenutzte Kapital in der Wallet; die Zahlungsabwicklungsgebühr zählt nicht zum erstattungsfähigen Kapital.
Senden Sie eine E-Mail an support@1zheai.com und nennen Sie Konto, Zeitpunkt der Aufladung und Zahlungsmethode.
Beim ersten Mal können Sie zunächst den von der Wallet erlaubten Betrag aufladen, dann die Prüfung nach [Modell und Verbrauch abgleichen](/de/docs/verify-model/) durchlaufen lassen und dann einige Tage in Ihren echten Aufgaben verwenden. Innerhalb von 7 Tagen kann das ungenutzte Kapital auf demselben Weg zurückgefordert werden, die Zahlungsabwicklungsgebühr wird nicht erstattet.
## Rechnungen
| Zahlungsmethode | Was ausgestellt werden kann |
|---|---|
| WeChat Pay / Alipay | Rechnung möglich, zusätzlich 6 % des Zahlungsbetrags |
| Stripe (Bankkarte) | Stripe invoice (englisch) |
| USDT | Keine Rechnung |
Für Rechnungen, Unternehmensbestellungen und Überweisungen auf Firmenkonten senden Sie eine E-Mail an support@1zheai.com.
## Häufige Fragen
Die Betragsbeschränkung ergibt sich aus der Bestellseite der Wallet. Vor der Zahlung prüfen Sie das Aufladekapital, die Zahlungsabwicklungsgebühr und den Gutschriftbetrag.
Ist das Guthaben aufgebraucht, gibt die Anfrage HTTP 403 zurück, im Antwortkörper steht `Insufficient user quota` (auf `/v1/messages` ist `error.type` gleich `billing_error`, auf `/v1/chat/completions` gleich `insufficient_quota`). Abgelehnte Anfragen werden nicht abgebucht, nach Gutschrift der Aufladung können Sie weiter verwenden.
Aufrufe über Claude Code enthalten keine zusätzlichen Inhalte. Andere Clients (SDK, curl und Drittanbieter-Tools) hängen jeder Anfrage einen Systemhinweis an, abgerechnet nach Input-Token: bei Sonnet 4.6 etwa 350 Token, bei der 5.x-Serie etwa 500 Token. Erläuterung und gemessene Daten siehe [Abrechnung des Systemhinweises](/de/docs/pricing-explained/#section-3).
Die API-Guthaben-Rückerstattung betrifft ungenutztes Kapital innerhalb von 7 Tagen nach der Aufladung, bereits verbrauchte Teile und die Zahlungsabwicklungsgebühr werden nicht erstattet. Für Fälle nach Ablauf der 7 Tage kontaktieren Sie uns bitte separat und schildern Sie den Sachverhalt.
---
# Modell und Verbrauch überprüfen
Source: https://1zheai.com/de/docs/verify-model/
Markdown: https://1zheai.com/de/docs/verify-model.md
---
title: "Modell und Verbrauch überprüfen"
description: "Mit dem Aufrufprotokoll und fünf Prüfungen das Modell, den Token-Verbrauch und die Kosten jedes Aufrufs überprüfen."
headingIds: {"Aufrufprotokoll":"section-1","Fünf Prüfungen":"section-2","Die ersten vier Prüfungen per Skript durchführen":"section-3","thinking-Block":"section-4","Bei Unstimmigkeiten":"section-5","Häufige Fragen":"section-6"}
---
## Aufrufprotokoll
Jeder Aufruf wird im [Aufrufprotokoll](/de/docs/usage-logs/) der Konsole protokolliert und listet das Modell, den Token-Verbrauch für Eingabe, Ausgabe, Cache-Lesezugriffe und Cache-Schreibzugriffe sowie die Kosten auf.
## Fünf Prüfungen
Die folgenden Prüfungen beziehen sich auf das öffentliche Format der Anthropic-Schnittstelle und dienen dazu, Abweichungen bei den zurückgegebenen Feldern und im Format zu erkennen.
| Prüfung | Erwartetes Ergebnis | Zu beachten |
|---|---|---|
| 1. Zurückgegebenes `model`-Feld | Stimmt mit der angeforderten Modell-ID überein | Gibt einen anderen Modellnamen zurück oder das Feld fehlt |
| 2. Cache-Lesezugriff | Dieselbe Anfrage, die die Cache-Bedingungen erfüllt, wird zweimal innerhalb der Cache-Gültigkeitsdauer gesendet; `cache_read_input_tokens` des zweiten Aufrufs ist größer als 0 | Immer 0 oder `usage` enthält keine Cache-Felder |
| 3. Tool-Aufruf-ID | `id` des `tool_use`-Blocks beginnt mit `toolu_` | Anderes Format oder das Modell ruft die Tools nicht wie angefordert auf |
| 4. Reihenfolge der Streaming-Ereignisse | `message_start`, `content_block_start`, `content_block_delta`, `message_delta` und `message_stop` treten der Reihe nach auf | Nur `data:`-Block im OpenAI-Format oder Ereignisse fehlen bzw. sind falsch geordnet |
| 5. Abgleich mit einer realen Aufgabe | Ergebnisse mit einer festen Aufgabe gegen die offizielle API oder andere verlässliche Quellen vergleichen | Deutlich schlechtere Ergebnisse, ungewöhnliche Ablehnungen oder häufige Abbrüche |
Diese Prüfungen können nur Abweichungen bei Feldern und Format erkennen und das tatsächlich verwendete Modell nicht allein bestätigen. `model`-Felder können umgeschrieben und das Format kann nachgeahmt werden.
## Die ersten vier Prüfungen per Skript durchführen
Erforderlich sind `bash`, `curl` und `jq`. Das Skript startet fünf kleine Aufrufe, von denen einer etwa 18.000 Token in den Cache schreibt und zum regulären Preis berechnet wird.
```bash title="verify.sh"
#!/usr/bin/env bash
# 用法：ONEZHE_API_KEY=sk-你的API密钥 bash verify.sh [模型ID]
set -euo pipefail
BASE="https://1zheai.com"
MODEL="${1:-claude-sonnet-5-5}"
H=(-H "x-api-key: $ONEZHE_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json")
echo "== 1. model 字段"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:16,messages:[{role:"user",content:"ping"}]}')" \
| jq 'if .error then .error else {id, model, usage} end'
echo "== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens"
LONG=$(printf '这是一段用来测试缓存的固定文本，内容不重要，长度够就行。%.0s' {1..600})
BODY=$(jq -n --arg m "$MODEL" --arg t "$LONG" '{model:$m,max_tokens:16,
system:[{type:"text",text:$t,cache_control:{type:"ephemeral"}}],
messages:[{role:"user",content:"ping"}]}')
for i in 1 2; do
curl -s "$BASE/v1/messages" "${H[@]}" -d "$BODY" | jq -c 'if .error then .error else .usage end'
done
echo "== 3. 工具调用 ID"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:256,
tools:[{name:"get_weather",description:"查询城市天气",
input_schema:{type:"object",properties:{city:{type:"string"}},required:["city"]}}],
tool_choice:{type:"auto"},
messages:[{role:"user",content:"北京今天天气怎么样"}]}')" \
| jq -r 'if .error then .error.message else (.content[]? | select(.type=="tool_use") | .id) end'
echo "== 4. 流式事件序列"
curl -sN "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:32,stream:true,messages:[{role:"user",content:"数到三"}]}')" \
| grep '^event:' | uniq
```
Prüfung 3 verwendet `tool_choice: auto`. 5.x-Modelle wie Sonnet 5.5 unterstützen keine erzwungene Tool-Angabe (`{"type":"tool"}` oder `{"type":"any"}`) und geben 400 `does not support forced tool_choice` zurück.
Am 2026-10-15 mit `claude-sonnet-5-5` gemessene Ausgabe (bei Prüfung 1 wurden nur die Schlüsselfelder behalten):
```text
== 1. model 字段
{
"id": "msg_011Cg3Esh8zeEdLeXAPVALKe",
"model": "claude-sonnet-5-5",
"usage": {
"input_tokens": 518,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 12,
...
}
}
== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens
{"input_tokens":23,"cache_creation_input_tokens":17920,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":17920,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
{"input_tokens":23,"cache_creation_input_tokens":0,"cache_read_input_tokens":17920,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
== 3. 工具调用 ID
toolu_01UPsdyKX8M9fJTTkDoSKHXA
== 4. 流式事件序列
event: message_start
event: content_block_start
event: ping
event: content_block_delta
event: content_block_stop
event: message_delta
event: message_stop
```
Ob das `ping`-Ereignis auftritt und an welcher Stelle, ist nicht festgelegt und beeinflusst die Beurteilung nicht.
## thinking-Block
Wenn thinking aktiviert ist, enthält der zurückgegebene `thinking`-Block das `signature`-Feld und kann ebenfalls als Formatprüfung verwendet werden. Die Schreibweise unterscheidet sich bei 5.x-Modellen von 4.x; gemessen am 2026-10-15:
| Modell | `thinking`-Parameter | Ergebnis |
|---|---|---|
| `claude-sonnet-4-6` | `{"type":"enabled","budget_tokens":1024}` | Gibt `thinking`-Block mit Denktext und `signature` zurück |
| `claude-sonnet-5` | `{"type":"enabled","budget_tokens":1024}` oder `{"type":"adaptive"}` | Beides funktioniert |
| `claude-sonnet-5-5` | `{"type":"adaptive"}` | Funktioniert; `enabled` gibt 400 zurück und weist darauf hin, dass nur adaptive unterstützt wird |
Der `thinking`-Block von 5.x-Modellen enthält standardmäßig nur `signature`; der Denktext ist eine leere Zeichenkette. Wenn die Denkzusammenfassung sichtbar sein soll, fügen Sie `"display": "summarized"` hinzu:
```json
"thinking": {"type": "adaptive", "display": "summarized"}
```
Bei der Verwendung von Drittanbieter-Prüfseiten wird empfohlen, einen neuen, dafür vorgesehenen API-Schlüssel anzulegen und ihn nach dem Test zu löschen.
## Bei Unstimmigkeiten
Senden Sie eine E-Mail an support@1zheai.com und fügen Sie die Anfragezeit, die Modell-ID, den vollständigen Rückgabewert (ohne API-Schlüssel) und den zugehörigen Prüfpunkt bei. Die request id in der Rückgabe oder Fehlermeldung hilft, diesen Aufruf zu lokalisieren.
## Häufige Fragen
Unzuverlässig. Die Selbstvorstellung des Modells wird vom Systemprompt beeinflusst und kann unter bestimmten Prompts die eigene Version falsch angeben. Die Prüfung der zurückgegebenen Felder und Ereignisformate ist aussagekräftiger.
Claude Code verwendet das Haiku-Modell für einige Hintergrundaufgaben; im Aufrufprotokoll erscheinen die entsprechenden Einträge. Mit der Umgebungsvariable `ANTHROPIC_DEFAULT_HAIKU_MODEL` lässt sich das Modell für solche Aufgaben festlegen, siehe [Claude-Code-Anbindung](/de/docs/quickstart-claude-code/). Wenn dies ohne Claude Code auftritt, senden Sie die Anfragezeit an support@1zheai.com.
---
# Fehlercodes und Fehlersuche
Source: https://1zheai.com/de/docs/troubleshooting/
Markdown: https://1zheai.com/de/docs/troubleshooting.md
---
title: "Fehlercodes und Fehlersuche"
description: "Ursachen und Lösungen für 401, 404, 429, 529, 5xx, Timeouts und Claude-Code-Fehler beim Aufruf von 1折AI."
headingIds: {"Reihenfolge der Fehlersuche":"section-1","Fehlercode-Schnellreferenz":"section-2","Getestete Antworten":"section-3","Fehlersuche nach Symptomen":"section-4","401 / Invalid token":"section-5","004 / Invalid URL":"section-6","403 / error code: 1010":"section-7","429 Zu viele Anfragen":"section-8","529 / overloaded_error":"section-9","Timeouts, Abbruch mitten im Stream":"section-10","Claude Code: Direkt im Anmeldebildschirm":"section-11","Claude Code: Extra inputs are not permitted / context_management meldet 400":"section-12","Guthaben ausreichend, aber Aufruf schlägt fehl":"section-13","Begrenzte Wiederholungen und Feedback-Vorlage":"section-14","Immer noch nicht gelöst":"section-15"}
---
Gehen Sie zuerst die folgende Liste der Reihe nach durch – die meisten Probleme lassen sich in den ersten drei Schritten finden.
## Reihenfolge der Fehlersuche
1. **Adresse**: Anthropic-basierte Tools mit `https://1zheai.com` ausfüllen, OpenAI-basierte mit `https://1zheai.com/v1`. Siehe [Base URL und Authentifizierung](/de/docs/base-url/).
2. **API-Schlüssel (API key)**: Ist er vollständig (ohne zusätzliche Leerzeichen oder Zeilenumbrüche), wurde er gelöscht, und ist er im richtigen Feld eingetragen?
3. **Guthaben**: Ist das Guthaben im Konsole ausreichend?
4. **Modell-ID**: Stimmt sie exakt mit der in [unterstützten Modellen](/de/docs/models/) überein?
5. **Netzwerk**: Proxy deaktivieren und direkt verbinden, dann erneut versuchen.
6. **Immer noch nicht gelöst**: Eine minimale curl-Wiedergabe erstellen (siehe unten) und uns die Antwort und die Zeit senden.
```bash title="最小复现"
curl -i https://1zheai.com/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
```
`-i` gibt den Statuscode und die Antwortheader mit aus, was bei der Fehlersuche sehr nützlich ist.
## Fehlercode-Schnellreferenz
| Statuscode | Häufige Ursache | Was zu tun ist |
|---|---|---|
| 400 | Problem mit dem Anfragekörper: falscher Parametername, falscher Feldtyp, `max_tokens` überschreitet das Modelllimit, enthaltenes Beta-Feld wird vom Upstream nicht anerkannt | Das in `message` angegebene Feld prüfen; für Claude Code siehe unten „Extra inputs are not permitted“ |
| 401 | API-Schlüssel ungültig, gelöscht, deaktiviert, abgelaufen, eigenes Kontingent aufgebraucht, oder fehlt bzw. ist im falschen Header platziert | Die Antwort enthält immer `Invalid token` – Punkt für Punkt prüfen; Anthropic-nativ verwendet `x-api-key` oder `Authorization: Bearer` |
| 403 | Unzureichendes Kontoguthaben (`billing_error` / `insufficient_quota`); dieser API-Schlüssel hat das Modell nicht freigeschaltet; die Anfrage-IP steht nicht auf der Whitelist dieses API-Schlüssels (alles `permission_error`) | Aufladen oder auf der Seite „API-Schlüssel“ die Modellbeschränkungen und die IP-Whitelist dieses API-Schlüssels bearbeiten |
| 004 | Pfad falsch oder Modell existiert nicht / derzeit nicht verfügbar | `Invalid URL` Adresse prüfen; `not_found_error` / `model_not_found` Modell-ID und verfügbare Liste prüfen |
| 413 | Anfragekörper zu groß | Inhalt pro Anfrage reduzieren, große Dateien aufteilen |
| 429 | Temporäres Rate-Limiting durch den Upstream. Wir setzen derzeit keine Ratenlimits auf API-Schlüssel | Später erneut versuchen, bei Stapelverarbeitung exponentielles Backoff hinzufügen |
| 503 | Modell vorhanden, aber derzeit kein gesunder Upstream-Dienst verfügbar, oder temporärer Dienstfehler | Später erneut versuchen; bei anhaltendem Fehler die Anfrage-ID angeben und den Support kontaktieren |
| 500 / 502 | Temporärer Gateway- oder Upstream-Fehler | Später erneut versuchen; bei anhaltendem Auftreten E-Mail an support@1zheai.com senden |
| 504 | Anfrage-Timeout | Für lange Ausgaben Streaming verwenden; Client-Timeout erhöhen |
| 529 | Upstream-Anthropic überlastet (`overloaded_error`) | Einige Sekunden warten und erneut versuchen oder vorübergehend ein anderes Modell verwenden |
Die vollständige Bedeutung der offiziellen Anthropic-Fehlertypen (`invalid_request_error`, `authentication_error`, `rate_limit_error`, `overloaded_error` usw.) finden Sie in der [offiziellen Errors-Dokumentation](https://platform.claude.com/docs/en/api/errors).
Vom Upstream zurückgegebene Fehler werden mit Statuscode und `message` unverändert weitergegeben; `message` wird am Ende um die request id dieser Anfrage ergänzt. Bei `/v1/messages` ist die äußere Struktur die offizielle `{"type":"error","error":{...}}`-Struktur, `error.type` wird je nach Statuscode mit dem offiziellen Typ gefüllt; bei `/v1/chat/completions` handelt es sich um die OpenAI-Struktur `{"error":{...}}`.
## Getestete Antworten
Nachfolgend die echten Antworten vom 15.10.2026 bei `/v1/messages`. Bei `/v1/chat/completions` ist der Inhalt identisch, die äußere Schicht hat kein `"type":"error"`, und `error` enthält zusätzlich ein Feld `code`.
```json title="401 API 密钥无效、禁用、过期或额度用完"
{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}
```
```json title="403 账户余额不足"
{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}
```
```json title="403 API 密钥没开通该模型"
{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}
```
```json title="403 IP 不在白名单"
{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}
```
```json title="400 上游参数错误"
{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}
```
```json title="404 路径不存在"
{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}
```
Eine Erläuterung des 404, wenn das Modell nicht existiert oder nicht verfügbar ist, finden Sie in [unterstützten Modellen](/de/docs/models/). Die request id in der Antwort entspricht genau dieser Anfrage – bitte bei Problemmeldungen angeben.
## Fehlersuche nach Symptomen
### 401 / Invalid token
- Beim Kopieren des API-Schlüssels sind Leerzeichen oder Zeilenumbrüche hinzugekommen – erneut kopieren.
- Der API-Schlüssel wurde in der Konsole gelöscht oder deaktiviert, ist abgelaufen oder das eigene Kontingent ist aufgebraucht. In all diesen Fällen lautet die Antwort exakt derselbe Satz `Invalid token`.
- In Claude Code sind gleichzeitig `ANTHROPIC_API_KEY` und `ANTHROPIC_AUTH_TOKEN` gesetzt, wobei einer der alte Wert ist: Nur eines behalten, empfohlen ist `ANTHROPIC_AUTH_TOKEN`.
- `settings.json` in `env` überschreibt die gleichnamige Variable, die im Terminal exportiert wurde. Wenn die Änderung der Terminal-Variable nicht wirkt, prüfen Sie `~/.claude/settings.json`.
### 004 / Invalid URL
Zuerst den Fehlertyp ansehen: `not_found_error` oder `model_not_found` erfordern die Prüfung der [Modell-ID und verfügbaren Liste](/de/docs/models/). Bei `Invalid URL` stattdessen `/v1` prüfen: OpenAI SDK, Cursor, Cline (OpenAI Compatible) müssen in `https://1zheai.com/v1` eingetragen werden; Claude Code und Anthropic SDK nur `https://1zheai.com`, das Eintragen von `/v1` führt zu `/v1/v1/messages`.
### 403 / error code: 1010
Wenn die Antwort nur die Zeile `error code: 1010` enthält und kein JSON, wurde die Anfrage vor Erreichen des Gateways blockiert. Bisher ist bekannt, dass dies beim direkten Senden mit der Python-Standardbibliothek `urllib` auftritt (deren Standard-User-Agent ist `Python-urllib/3.x`). Fügen Sie in den Anfrageheadern einen eigenen `User-Agent` hinzu oder verwenden Sie stattdessen das offizielle SDK, `requests`, `httpx`.
### 429 Zu viele Anfragen
Derzeit werden keine Ratenlimits auf API-Schlüssel gesetzt. Bei Erhalt von 429 liegt in der Regel eine hohe Upstream-Last vor – später erneut versuchen. Für Stapelverarbeitung wird exponentielles Backoff empfohlen: Nach einem Fehler eine Weile warten, die Wartezeit bei jedem Versuch verdoppeln und die Parallelität selbst über eine Warteschlange steuern.
### 529 / overloaded_error
Der Upstream-Anthropic ist vorübergehend überlastet, unabhängig von Ihrem API-Schlüssel oder Guthaben. Einige Sekunden warten und erneut versuchen; falls es eilt, vorübergehend auf ein anderes Modell derselben Serie wechseln.
### Timeouts, Abbruch mitten im Stream
- Lange Antworten nach Möglichkeit mit Streaming (`"stream": true`) – so werden sie nicht so leicht von Netzwerkgeräten dazwischen getrennt.
- Claude Code kann mit `API_TIMEOUT_MS` den Timeout erhöhen, Standard ist 600000 (10 Minuten).
- Wenn ein Proxy aktiv ist, zuerst den Proxy deaktivieren und erneut versuchen – viele Stream-Abbrüche stammen vom Proxy-Knoten.
### Claude Code: Direkt im Anmeldebildschirm
Das bedeutet, dass Claude Code Ihren API-Schlüssel nicht gelesen hat. Führen Sie in Claude Code `/status` aus und prüfen Sie die Zeilen für Base URL und Anmeldedatenquelle; wenn leer, zurück zu [Claude-Code-Anbindung](/de/docs/quickstart-claude-code/) und Umgebungsvariablen oder `settings.json` prüfen.
### Claude Code: Extra inputs are not permitted / context_management meldet 400
Claude Code sendet einige experimentelle Beta-Felder mit der Anfrage; strenge Upstreams erkennen diese nicht und melden dann 400. Setzen Sie die folgende Umgebungsvariable, um sie zu deaktivieren (aus der offiziellen Claude-Code-LLM-Gateway-Dokumentation):
```bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
```
### Guthaben ausreichend, aber Aufruf schlägt fehl
- Wenn nur ein bestimmtes Modell fehlschlägt, ist es möglicherweise derzeit nicht verfügbar, die ID ist falsch geschrieben, oder dieser API-Schlüssel hat eine Modellbeschränkung (403 `This token has no access to model …`).
- Wenn alle fehlschlagen und es 401 ist, prüfen Sie, ob für diesen API-Schlüssel ein Kontingentlimit gesetzt und bereits aufgebraucht ist oder ob er abgelaufen ist. Auf der Seite „API-Schlüssel“ in den Spalten „Kontingent ($)“ und „Ablauf“ einsehbar.
- Für andere Fälle die Fehlercodetabelle oben konsultieren.
## Begrenzte Wiederholungen und Feedback-Vorlage
Verdecken Sie keine Konfigurationsfehler mit Endlosschleifen. SDK-Timeouts, automatische Wiederholungsanzahl und Backoff-Verhalten siehe [Timeouts und Wiederholungen](/de/docs/retries/).
Beim Kontaktieren des Supports können Sie die folgende Vorlage kopieren, Schlüssel, Authentifizierungsheader und private Inhalte entfernen und dann senden:
```text
发生时间与时区：
客户端及版本：
请求方法与完整路径：
模型 ID：
HTTP 状态码：
request id（如有）：
脱敏后的错误正文：
最小请求能否复现：
是否使用代理 / 是否仅某个模型失败：
```
## Immer noch nicht gelöst
Senden Sie eine E-Mail an support@1zheai.com mit Zeitpunkt, Modell-ID, verwendetem Tool und Version sowie der vollständigen Ausgabe von `curl -i` (API-Schlüssel entfernt).
---
# KI und Automatisierung
Source: https://1zheai.com/de/docs/ai/
Markdown: https://1zheai.com/de/docs/ai.md
---
title: "KI und Automatisierung"
description: "Lassen Sie KI-Assistenten bei Bedarf Dokumentation lesen und erfahren Sie den aktuellen Stand der maschinenlesbaren Zugänge und der Dokumentations-MCP."
headingIds: {"Verfügbare maschinenlesbare Zugänge":"section-1","Zugangsaufgaben für KI":"section-2","Status der Dokumentations-MCP":"section-3"}
---
Sie können einen KI-Assistenten zuerst die Dokumentation dieser Website lesen lassen und ihn dann bei der Konfiguration von Tools oder beim Schreiben von Aufrufcode unterstützen. Das Lesen von Dokumentation und das Aufrufen der Modell-API sind zwei verschiedene Dinge: Das Lesen öffentlicher Dokumentation erfordert keinen API-Schlüssel.
## Verfügbare maschinenlesbare Zugänge
| Zugang | Zweck |
| --- | --- |
| [llms.txt](/de/docs/llms.txt) | Dokumentation nach Rubriken entdecken und die zu lesenden Seiten auswählen |
| [Dokumentationsverzeichnis](/de/docs/docs-manifest.json) | Seitentitel, zugehörige Rubrik sowie Web- und Markdown-Adresse abrufen |
| [Vollständiger Dokumentationstext](/de/docs/llms-full.txt) | Alle Seiten auf einmal lesen; der Inhalt ist lang, daher Seitenweise lesen vorziehen |
| [Startseiten-Markdown](/de/docs/index.md) | Den Quelldokumentationsinhalt ohne Seitennavigation lesen |
Jeder Artikel hat eine zugehörige Markdown-Adresse, z. B. entspricht `/de/docs/quickstart-claude-code/` `/de/docs/quickstart-claude-code.md`. Alternativ können Sie „Diese Seite kopieren“ am Seitenanfang verwenden. In Markdown können Markierungen von Dokumentationskomponenten wie Karten erhalten bleiben.
## Zugangsaufgaben für KI
Aufgabenbeschreibung kopieren, damit der Assistent zuerst den unterstützten Umfang prüft und dann konfiguriert und verifiziert. Protokoll, Adresse und Modellkonfiguration je nach Tool auswählen.
## Status der Dokumentations-MCP
Diese Website bietet derzeit noch keinen verbindbaren Dokumentations-MCP-Server. Verwenden Sie zunächst die oben genannten Dokumentationsadressen oder kopieren Sie den Seiteninhalt an den Assistenten; behandeln Sie die Base-URL der Modell-API nicht als MCP-Adresse.
Der Zweck der Dokumentations-MCP besteht darin, öffentliche Materialien zu durchsuchen und zu lesen. Kontenabfragen, Schlüsselverwaltung und ähnliche Vorgänge sind eine andere Fähigkeitsklasse und sind über den öffentlichen Dokumentationszugang nicht erhältlich.
---
# Lass die KI dir beim Einrichten helfen
Source: https://1zheai.com/de/docs/agent-workflow/
Markdown: https://1zheai.com/de/docs/agent-workflow.md
---
title: "Lass die KI dir beim Einrichten helfen"
description: "Kopierbare Aufgabenanweisung, die der KI hilft, zuerst die Unterlagen zu lesen, die Einschränkungen zu prüfen und dann die Konfiguration und Verifizierung abzuschließen."
headingIds: {"Aufgabenanweisung kopieren":"section-1","Prüfen, ob abgeschlossen":"section-2"}
---
## Aufgabenanweisung kopieren
Gib die folgende Anweisung an einen KI-Assistenten weiter, der Webseiten lesen kann, und ergänze den Werkzeugnamen und das Betriebssystem. Falls der Assistent keinen Internetzugang hat, hole dir den entsprechenden Artikelinhalt zuerst über den[maschinenlesbaren Zugang](/de/docs/ai/).
```text
请帮助我将现有工具或应用接入 1折AI。
目标工具与版本：[填写]
操作系统或编程语言：[填写]
先读取 https://1zheai.com/de/docs/llms.txt，找到目标工具或 SDK 的文档。
再读取该页 Markdown，以及 API 参考和模型说明。
要求：
1. 先说明当前支持范围和工具配置要求。
2. 根据目标工具确定 Base URL，不要统一添加或删除 /v1。
3. 模型 ID 以当前文档和密钥可用模型列表为准，不要猜测。
4. 查看现有配置，只修改必要字段，保留其他供应商配置。
5. 使用环境变量或工具提供的凭据存储方式；不要把密钥写入源码、
对话、日志或提交记录。需要密钥时，让我在本地安全配置。
6. 执行会产生费用的测试前，说明测试内容并取得我的同意。
7. 用一次最小请求验证，再提示我在调用日志里核对记录。
8. 如果验证失败，保留脱敏的状态码与请求 ID，按排错文档处理；
不要用反复重试掩盖配置问题。
9. 最后说明修改位置、验证结果、剩余限制及恢复原配置的方法。
```
## Prüfen, ob abgeschlossen
Die Konfiguration abzuschließen bedeutet nicht, dass die Einrichtung abgeschlossen ist. Bestätige gleichzeitig, dass das Werkzeug normal antwortet, das tatsächlich verwendete Modell den Erwartungen entspricht und im[Aufrufprotokoll](/de/docs/usage-logs/) der entsprechende Eintrag zu finden ist.
Diese Seite ist eine kopierbare Aufgabenanweisung und kein installierter Agent Skill oder MCP-Dienst. Jeder Assistent benötigt weiterhin die entsprechenden Fähigkeiten, um Dokumentationen zu lesen und lokale Konfigurationen zu bearbeiten.
---