Obsidian Copilot + Heli: свой провайдер в BYOK

Copilot for Obsidian — плагин, который добавляет в Obsidian чат с моделями, быстрые команды над заметками и агентный режим. Режим Bring Your Own Key подключает любой OpenAI-совместимый endpoint без лицензии Copilot: запросы идут напрямую к выбранному сервису, а оплата — у него. Так в Obsidian подключается Heli: один ключ sk-heli-… и модели разных вендоров с оплатой в рублях.

Пошаговая настройка

Enable CORS оставьте выключенным: с ним ответы приходят целиком, без потокового вывода. Включать его стоит, только если Test проходит, а чат не может отправить запрос. Ключ плагин хранит в Keychain Obsidian на этом устройстве, и синхронизация хранилища его не переносит.

  • Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID) и создайте ключ на вкладке «Ключи» кабинета.
  • В Obsidian откройте Settings → Copilot → вкладка BYOK и нажмите Add a provider.
  • Внизу списка выберите Add a custom provider — отдельный провайдер, а не изменённый адрес встроенного OpenAI.
  • Display name: Heli. API key: ключ sk-heli-…. Base URL: https://getheli.ru/v1 — без /chat/completions, плагин добавит путь сам.
  • Нажмите Test: плагин запросит список моделей. Отметьте нужные или введите точный слаг в Model ID и нажмите Add.
  • Нажмите Save, затем выберите модель по умолчанию для Quick Chat в Basic → Agents.

Итоговые настройки

code
Provider:      Add a custom provider
Display name:  Heli
API key:       sk-heli-ВАШ_КЛЮЧ
Base URL:      https://getheli.ru/v1
Enable CORS:   off
Model ID:      anthropic/claude-sonnet-5
               google/gemini-3.5-flash
               deepseek/deepseek-v4-flash

Какие модели выбрать

Для работы с длинными заметками и исследовательских вопросов нужна модель с большим контекстом, для быстрых команд вроде «перефразируй» или «сделай список задач» — быстрая и недорогая. Модель для быстрых команд задаётся отдельно во вкладке Command.

Claude Sonnet 5 — длинные заметки, анализ, агентный режим.

Gemini 3.5 Flash — быстрые команды и Quick Ask.

DeepSeek V4 Flash — черновики и перевод.

Частые ошибки

  • Test не проходит, 401 — ключ неверный или отозван; создайте новый на вкладке «Ключи».
  • 404 или двойной путь в ошибке — в Base URL вставлен полный адрес /v1/chat/completions; оставьте https://getheli.ru/v1.
  • 402 insufficient_balance — закончился баланс; пополните его, провайдер перенастраивать не нужно.
  • Модель не найдена — Model ID должен совпадать со слагом из GET /v1/models, включая префикс вендора.
  • Таймауты на больших заметках — сократите контекст или выберите более быструю модель.

Документация API

Оплата — пополнение баланса.

Безопасность ключа sk-heli-

Попробуйте Heli

Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.

Документация API · Модели и цены

Читайте также