Клиенты/WorkBuddy

Wokey API в WorkBuddy

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

Обновлено

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

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

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

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

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

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

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

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

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

WorkBuddy использует OpenAI Chat Completions для пользовательских моделей. В WorkBuddy откройте Настройки → Модель → Пользовательские модели и укажите адрес Wokey, API-ключ и deepseek-flash; после этого задачи и Agent-сценарии WorkBuddy смогут использовать инструменты и изображения.

  1. 1

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

    Нажмите кнопку аккаунта в левом нижнем углу WorkBuddy → Настройки → Модель. Также можно открыть выбор модели и выбрать «Настроить пользовательскую модель».

  2. 2

    Добавьте пользовательскую модель

    Выберите Custom. Укажите адрес https://api.wokey.ai, вставьте API-ключ Wokey и введите точный ID модели deepseek-flash. Не используйте отображаемое имя DeepSeek-V4.1-Flash как ID модели.

  3. 3

    Настройте возможности

    Включите вызов инструментов и ввод изображений, а режим рассуждений и пользовательский протокол оставьте выключенными. deepseek-flash принимает текст, изображения и инструменты; если используете deepseek-v4-flash, отключите ввод изображений — эта модель работает только с текстом.

  4. 4

    Сохраните и выберите модель

    Нажмите «Проверить подключение», сохраните модель и выберите её в списке моделей диалога. Сначала отправьте короткий текстовый запрос, затем проверьте инструменты или изображения.

WorkBuddy
Поставщик: Custom
Адрес интерфейса: https://api.wokey.ai
API-ключ: YOUR_API_KEY
Модель: deepseek-flash
Вызов инструментов: Вкл.
Ввод изображений: Вкл.
Режим рассуждений: Выкл.
Пользовательский протокол: Выкл.

Частые проблемыlink

  • 404: оставьте адрес https://api.wokey.ai и выключите пользовательский протокол. Полный путь https://api.wokey.ai/v1/chat/completions указывайте только при включённом пользовательском протоколе.
  • 401: вставляйте в поле API-ключа сам ключ без префикса Bearer. Проверьте, что ключ активен и на балансе есть средства.
  • model_not_found: ID модели должен быть deepseek-flash. DeepSeek-V4.1-Flash — это отображаемое имя, а не ID модели Wokey.
  • Ошибка изображения: выберите deepseek-flash и включите ввод изображений. deepseek-v4-flash принимает только текст.
  • 429, 502, 504 или 529: снизьте параллелизм, сократите контекст или повторите запрос позже; можно также выбрать другую доступную модель.

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

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

WorkBuddy по умолчанию использует формат 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": "deepseek-flash",
    "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), это может быть временное ограничение после нарушений.

502

upstream unavailable

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

504

upstream timeout

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

529

upstream overloaded

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