Клиенты/Z Code

Wokey API в Z Code

Получите API-ключ Wokey, укажите в Z Code base URL Wokey и проверьте подключение одним curl-запросом.

Обновлено

На этой страницеexpand_more

Получите API-ключ и Base URLlink

Все клиенты используют один и тот же API-ключ Wokey и один и тот же Base URL.

Создайте API-ключ

Войдите и создайте ключ платформы на странице API. Ключи одного аккаунта используют общий баланс.

Создать API-ключkey

Используйте Base URL Wokey

Укажите в качестве Base URL клиента домен шлюза; из конфигурации ниже видно, нужно ли добавлять /v1.

Настройте клиентlink

В Z Code пользовательские провайдеры добавляются на странице настроек; поддерживаются форматы API Anthropic и OpenAI. Для моделей Claude используйте формат Anthropic.

  1. 1

    Откройте настройки моделей

    Нажмите на имя модели в окне чата → Manage Models или откройте Settings → Model Settings.

  2. 2

    Добавьте провайдера

    Нажмите Add Provider и назовите его Wokey. Для формата Anthropic укажите Base URL https://api.wokey.ai, для формата OpenAI укажите https://api.wokey.ai/v1. В поле API Key вставьте API-ключ Wokey.

  3. 3

    Добавьте и включите модель

    В этом провайдере нажмите Add Model, введите ID модели, например claude-opus-5-5, и включите её переключателем.

  4. 4

    Переключите модель

    Вернитесь в окно чата, выберите добавленную модель в списке и отправьте короткое сообщение для проверки.

Z Code
Имя провайдера: Wokey
Формат API: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
ID модели: claude-opus-5-5

Форматы API и Base URLlink

Когда клиент переключается на другой формат API, наличие /v1 в Base URL может измениться.

ФорматBase URLДля чего
Anthropic Messageshttps://api.wokey.aiМодели Claude
OpenAI Chat Completionshttps://api.wokey.ai/v1DeepSeek, GLM, Kimi и другие модели

Где настраивается: Settings → Model Settings (файл ~/.zcode/v2/config.json)

Проверка через curllink

Если клиент выдаёт ошибку, сначала исключите проблемы с ключом и Base URL с помощью curl.

Z Code по умолчанию использует формат Anthropic Messages. Ответ 200 на этот запрос означает, что ключ и Base URL указаны верно. Перед отправкой замените YOUR_API_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" }
    ]
  }'

Ошибки и устранение неполадокlink

Сначала отделите ошибки авторизации, баланса, ограничения частоты запросов, недоступности модели и таймаута на стороне апстрима.

401

invalid api key

Ключ отсутствует, указан с ошибкой, удалён, либо заголовки Authorization / x-api-key противоречат друг другу.

402

insufficient balance

Недостаточно средств на балансе. Пополните баланс, чтобы продолжить отправлять запросы.

403

model_denylisted / account_restricted

Вызовы модели или всех моделей аккаунта приостановлены после повторных нарушений. Подробнее — в разделе «Сбор за нарушения и ограничения».

403

request_blocked

Запрос заблокирован до отправки в апстрим и не оплачивается: например, повторная отправка без изменений запроса, который модель только что отклонила, или приостановленный конечный пользователь (X-End-User-Id). В сообщении об ошибке указано, что именно заблокировано; измените запрос по подсказке или повторите попытку позже. Другие запросы это не затрагивает.

429

rate limited

Слишком частые запросы. Повторите позже или снизьте параллелизм. Если 429 постоянно возвращается только для одной модели или одного конечного пользователя (X-End-User-Id), это может быть временное ограничение после нарушений.

499

client disconnected

Клиент закрыл соединение до завершения ответа (code downstream_aborted). По умолчанию это бесплатно. Если за последние 24 часа у аккаунта не меньше 50 отключений клиента и они составляют 10% запросов или больше, последующие прерванные запросы оплачиваются по данным апстрима: обработанный ввод, включая чтение и запись кэша, а вывод — только если апстрим его подсчитал. Отключение до того, как апстрим сообщил об использовании, остаётся бесплатным. Аккаунт получает уведомление, когда оплата начинается, а когда доля отключений возвращается в норму, оплата автоматически прекращается в течение часа. Обычно причина — слишком короткий тайм-аут клиента или прокси либо программа, которая отменяет запросы до их завершения.

502

upstream unavailable

Сервис модели на стороне апстрима временно недоступен. Переключитесь на другую модель или повторите позже.

504

upstream timeout

Истекло время ожидания ответа апстрима. Сократите контекст, уменьшите max_tokens или повторите запрос.

529

upstream overloaded

Модель на стороне апстрима временно перегружена; Wokey уже повторил запрос по другим маршрутам (code upstream_overloaded). С вашим балансом это не связано. Повторите чуть позже или переключитесь на другую модель.

Частые вопросыlink

Нужно ли добавлять /v1 в Base URL для Z Code?
Зависит от формата API, через который вы подключаетесь. Для Anthropic укажите https://api.wokey.ai без /v1; для OpenAI укажите https://api.wokey.ai/v1.
Почему переменные окружения из терминала не действуют?
Переменные окружения терминала и настройки моделей в настольном Z Code существуют отдельно и не синхронизируются. Укажите Base URL и API-ключ в провайдере в разделе Settings → Model Settings.
Провайдер добавлен, но модель выбрать нельзя. Почему?
Для провайдера нужно ещё нажать Add Model, указать ID модели и включить её переключателем. После этого она появится в списке моделей в окне чата.
Что делать, если ответ обрезается или не хватает контекста?
Откройте Advanced у модели и задайте Max output tokens и context window по значениям со страницы модели. У новой модели контекстное окно по умолчанию равно 200000.
Где Z Code хранит эти настройки?
В файле ~/.zcode/v2/config.json. Сделайте его копию перед переносом на другой компьютер или переустановкой; в файле есть API-ключ, поэтому не передавайте его другим.