Клиенты/Magpie

Wokey API в Magpie

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

Обновлено

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

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

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

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

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

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

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

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

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

Magpie — шлюз моделей, который работает на вашем компьютере. После добавления Wokey как провайдера все агенты на этом компьютере могут вызывать модели Wokey через него. Magpie хранит отдельный адрес для каждого формата API, и одна команда задаёт все три.

  1. 1

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

    Выполните команду magpie provider add ниже, заменив YOUR_API_KEY на API-ключ Wokey. Для url и responses укажите https://api.wokey.ai/v1, для anthropic укажите https://api.wokey.ai без /v1. Без параметра models Magpie загрузит список моделей из Wokey.

  2. 2

    Или используйте ссылку импорта

    В Magpie 0.1.8 и новее откройте https://usemagpie.ai/import#name=Wokey&chat=https://api.wokey.ai/v1&anthropic=https://api.wokey.ai, вставьте API-ключ в диалоге и подтвердите.

  3. 3

    Выберите модель в агенте

    Имя модели записывается как wokey/ID модели, например wokey/claude-opus-5-5.

Magpie
magpie provider add "Wokey" \
  url=https://api.wokey.ai/v1 \
  responses=https://api.wokey.ai/v1 \
  anthropic=https://api.wokey.ai \
  key=YOUR_API_KEY

Форматы API и Base URLlink

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

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

Где настраивается: magpie provider add или ссылка импорта (файл ~/.config/magpie/providers.json)

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

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

Magpie по умолчанию использует формат OpenAI Chat Completions. Ответ 200 на этот запрос означает, что ключ и Base URL указаны верно. Перед отправкой замените YOUR_API_KEY на свой ключ.

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "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 в адрес Wokey в Magpie?
Magpie хранит отдельный адрес для каждого формата. Для chat и responses укажите https://api.wokey.ai/v1, для anthropic укажите https://api.wokey.ai без /v1. Адрес должен начинаться с https.
Что делать, если ссылка импорта не срабатывает?
Ссылки импорта работают в Magpie 0.1.8 и новее. Сначала обновитесь или добавьте провайдера командой magpie provider add.
Как записывать имя модели в агенте?
В виде id провайдера/имя модели. Провайдер с именем Wokey получает id wokey, поэтому Claude Opus 5.5 записывается как wokey/claude-opus-5-5.
Где указать API-ключ Wokey?
Вставьте ключ в диалоге импорта или передайте его в параметре key= команды magpie provider add. Magpie хранит его в ~/.config/magpie/providers.json.
Можно ли делиться ссылкой импорта с ключом?
Не стоит. Параметр key записан открытым текстом, и любой, у кого есть ссылка, сможет тратить ваш баланс. Перед отправкой уберите параметр key: получатель введёт свой ключ в диалоге импорта.