Soll die Base URL von Z Code auf /v1 enden?

Das hängt vom API-Format ab, über das du dich verbindest. Für Anthropic verwendest du https://api.wokey.ai ohne /v1; für OpenAI https://api.wokey.ai/v1.

Warum werden die Umgebungsvariablen ignoriert, die ich im Terminal exportiert habe?

Umgebungsvariablen im Terminal und die Modelleinstellungen der Desktop-App von Z Code sind getrennt und werden nicht synchronisiert. Trage Base URL und API-Key beim Provider unter Settings → Model Settings ein.

Der Provider ist angelegt. Warum kann ich kein Modell auswählen?

Für jeden Provider musst du zusätzlich über Add Model eine Modell-ID eintragen und den Schalter zum Aktivieren des Modells einschalten, erst dann erscheint es in der Modellliste des Chatfensters.

Was tun, wenn die Ausgabe abgeschnitten wird oder der Kontext nicht reicht?

Öffne Advanced beim Modell und passe Max output tokens und context window an die Werte von der Modellseite an. Ein neu hinzugefügtes Modell hat standardmäßig ein Kontextfenster von 200000.

Wo speichert Z Code diese Konfiguration?

In ~/.zcode/v2/config.json. Sichere die Datei, bevor du den Rechner wechselst oder neu installierst; sie enthält deinen API-Key, gib sie also nicht weiter.

Clients/Z Code

Wokey API mit Z Code nutzen

Hol dir einen Wokey-API-Key, trag in Z Code die Base URL von Wokey ein und prüf die Verbindung mit einer curl-Anfrage.

Aktualisiert 2026-11-10

Auf dieser Seiteexpand_more

Vorbereiten
Einrichten
Formate
Prüfen
Fehlerbehebung
Häufige Fragen

API-Key und Base URL bereitlegenlink

Alle Clients nutzen denselben Wokey-API-Key und dieselbe Base URL.

API-Key erstellen

Melde dich an und erstelle auf der API-Seite einen Plattform-Key. Alle Keys eines Kontos teilen sich dessen Guthaben.

API-Key erstellenkey

Base URL von Wokey verwenden

Trag als Base URL des Clients die Gateway-Domain ein; die Konfiguration unten zeigt, ob /v1 angehängt wird.

Client einrichtenlink

In Z Code fügst du eigene Provider auf der Einstellungsseite hinzu; unterstützt werden die API-Formate von Anthropic und OpenAI. Nutze für Claude-Modelle das Anthropic-Format.

1
Modelleinstellungen öffnen
Klick im Chat-Feld auf den Modellnamen → Manage Models oder geh zu Settings → Model Settings.
2
Provider hinzufügen
Klick auf Add Provider und nenn ihn Wokey. Setz die Base URL für das Anthropic-Format auf https://api.wokey.ai, für das OpenAI-Format auf https://api.wokey.ai/v1. Füg deinen Wokey-API-Key bei API Key ein.
3
Modell hinzufügen und aktivieren
Klick unter dem Provider auf Add Model, gib eine Modell-ID wie claude-opus-5-5 ein und schalte den zugehörigen Schalter ein.
4
Modell wechseln
Wähl zurück im Chat-Feld das hinzugefügte Modell aus der Modellliste und sende zur Kontrolle eine kurze Nachricht.

Z Code

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

API-Formate und Base URLslink

Wechselt ein Client das API-Format, kann sich ändern, ob die Base URL auf /v1 endet.

Format	Base URL	Geeignet für
Anthropic Messages	https://api.wokey.ai	Claude-Modelle
OpenAI Chat Completions	https://api.wokey.ai/v1	DeepSeek, GLM, Kimi und andere Modelle

Wo es konfiguriert wird: Settings → Model Settings (Datei ~/.zcode/v2/config.json)

Mit curl prüfenlink

Meldet der Client einen Fehler, schließ zuerst mit curl Probleme mit Key und Base URL aus.

Z Code nutzt standardmäßig das Format Anthropic Messages. Antwortet diese Anfrage mit 200, stimmen Key und Base URL. Ersetze vor dem Senden YOUR_API_KEY durch deinen Key.

cURL

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Fehler und Fehlerbehebunglink

Unterscheide zuerst zwischen Authentifizierung, Guthaben, Rate-Limit, nicht verfügbarem Modell und Upstream-Timeout.

401

invalid api key

Der Key fehlt, ist falsch geschrieben oder gelöscht, oder die Header Authorization und x-api-key widersprechen sich.

402

insufficient balance

Das Guthaben des Kontos reicht nicht aus. Lade Guthaben auf, bevor du weitere Anfragen sendest.

403

model_denylisted / account_restricted

Aufrufe des Modells oder aller Modelle des Kontos sind nach wiederholten Verstößen pausiert. Siehe „Bearbeitungsgebühren für Verstöße und Einschränkungen“.

403

request_blocked

Diese Anfrage wurde blockiert, bevor sie den Upstream erreicht hat, und wird nicht berechnet – etwa das unveränderte erneute Senden einer Anfrage, die das Modell gerade abgelehnt hat, oder ein pausierter Endnutzer (X-End-User-Id). Die Fehlermeldung nennt, was blockiert ist; ändere die Anfrage entsprechend oder versuch es später erneut. Andere Anfragen sind nicht betroffen.

429

rate limited

Zu viele Anfragen in kurzer Zeit. Versuch es später erneut oder verringere die Parallelität. Liefert nur ein Modell oder ein Endnutzer (X-End-User-Id) dauerhaft 429, kann das ein vorübergehendes Limit nach Verstößen sein.

499

client disconnected

Der Client hat die Verbindung geschlossen, bevor die Antwort fertig war (Code downstream_aborted). Das ist standardmäßig kostenlos. Hat ein Konto in den letzten 24 Stunden mindestens 50 Client-Abbrüche und machen diese 10 % oder mehr seiner Anfragen aus, werden spätere abgebrochene Anfragen nach der vom Upstream gemeldeten Nutzung berechnet: die verarbeitete Eingabe einschließlich Cache-Lesen und Cache-Schreiben sowie Ausgabe nur, wenn der Upstream sie gezählt hat. Ein Abbruch, bevor der Upstream Nutzung gemeldet hat, bleibt kostenlos. Das Konto wird benachrichtigt, wenn die Berechnung beginnt, und sie endet automatisch innerhalb einer Stunde, sobald die Abbruchquote wieder normal ist. Die übliche Ursache ist ein zu kurzer Timeout im Client oder Proxy oder ein Programm, das Anfragen abbricht, bevor sie fertig sind.

502

upstream unavailable

Der Upstream-Modelldienst ist vorübergehend nicht verfügbar. Wechsle das Modell oder versuch es später erneut.

504

upstream timeout

Die Antwort des Upstreams hat zu lange gedauert. Kürze den Kontext, verringere max_tokens oder versuch es erneut.

529

upstream overloaded

Das Upstream-Modell ist vorübergehend überlastet, und Wokey hat es bereits über andere Routen erneut versucht (Code upstream_overloaded). Mit deinem Guthaben hat das nichts zu tun. Versuch es in Kürze erneut oder wechsle das Modell.

Häufige Fragenlink

Soll die Base URL von Z Code auf /v1 enden?: Das hängt vom API-Format ab, über das du dich verbindest. Für Anthropic verwendest du https://api.wokey.ai ohne /v1; für OpenAI https://api.wokey.ai/v1.
Warum werden die Umgebungsvariablen ignoriert, die ich im Terminal exportiert habe?: Umgebungsvariablen im Terminal und die Modelleinstellungen der Desktop-App von Z Code sind getrennt und werden nicht synchronisiert. Trage Base URL und API-Key beim Provider unter Settings → Model Settings ein.
Der Provider ist angelegt. Warum kann ich kein Modell auswählen?: Für jeden Provider musst du zusätzlich über Add Model eine Modell-ID eintragen und den Schalter zum Aktivieren des Modells einschalten, erst dann erscheint es in der Modellliste des Chatfensters.
Was tun, wenn die Ausgabe abgeschnitten wird oder der Kontext nicht reicht?: Öffne Advanced beim Modell und passe Max output tokens und context window an die Werte von der Modellseite an. Ein neu hinzugefügtes Modell hat standardmäßig ein Kontextfenster von 200000.
Wo speichert Z Code diese Konfiguration?: In ~/.zcode/v2/config.json. Sichere die Datei, bevor du den Rechner wechselst oder neu installierst; sie enthält deinen API-Key, gib sie also nicht weiter.