Heli
Создать аккаунт

Heli + Dify: провайдер OpenAI-API-compatible

Dify — open-source платформа для LLM-приложений: чат-боты, агенты, workflow и RAG по базе знаний. Модели в Dify подключаются через провайдеров, и для любого OpenAI-совместимого API есть провайдер OpenAI-API-compatible. Через него в Dify добавляется Heli: один ключ sk-heli-…, модели разных вендоров и оплата в рублях с российского баланса.

Подготовка

  • Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID) и создайте ключ на вкладке «Ключи» кабинета.
  • В Dify 1.x провайдеры моделей устанавливаются как плагины: откройте Settings → Model Provider, найдите OpenAI-API-compatible и установите его.
  • Проверьте, что сервер с Dify (для self-hosted) имеет исходящий HTTPS-доступ к getheli.ru.

Добавление модели

Каждая модель добавляется отдельной записью с тем же endpoint и ключом. Для базы знаний добавьте ещё одну модель с типом Text Embedding — например openai/text-embedding-3-small — и выберите её в настройках Knowledge. При сохранении Dify делает тестовый запрос, так что ошибки в URL или ключе видны сразу.

  • Model Provider → OpenAI-API-compatible → Add Model.
  • Model Type: LLM.
  • Model Name: слаг модели Heli с префиксом вендора, например anthropic/claude-sonnet-5.
  • API Key: ваш ключ sk-heli-….
  • API endpoint URL: https://getheli.ru/v1 — без /chat/completions на конце.
  • Completion mode: Chat. Model context size и лимит max tokens — по карточке модели.
  • Для агентов и workflow с инструментами включите поддержку Function calling, если модель её умеет.
code
Model Type:        LLM
Model Name:        anthropic/claude-sonnet-5
API Key:           sk-heli-ВАШ_КЛЮЧ
API endpoint URL:  https://getheli.ru/v1
Completion mode:   Chat

# Проверка ключа и слага вне Dify
curl https://getheli.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-sonnet-5", "messages": [{"role": "user", "content": "ping"}]}'

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

Для агентов и сложных workflow нужна модель с надёжным tool calling, для массовых чат-ботов — быстрая и недорогая. Эмбеддинги выбирайте один раз: смена модели эмбеддингов потребует переиндексации базы знаний.

Claude Sonnet 5 — агенты, длинные документы, сложные цепочки.

Gemini 3.5 Flash — быстрые ответы бота, классификация, извлечение данных.

text-embedding-3-small — эмбеддинги для Knowledge.

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

  • Credentials validation failed при сохранении — проверьте, что URL заканчивается на /v1, ключ скопирован целиком, а слаг модели существует.
  • 401 — неверный или отозванный ключ: создайте новый на вкладке «Ключи».
  • 402 insufficient_balance — закончился баланс; пополните его в кабинете, приложение продолжит работу без перенастройки.
  • Модель не найдена — в Model Name нет префикса вендора или есть опечатка; точные слаги отдаёт GET /v1/models.
  • Таймауты в workflow — уменьшите лимит max tokens, разбейте длинный шаг на несколько или выберите более быструю модель.

Документация API — формат запросов и коды ответов.

Оплата — как пополнить баланс в рублях.

Все интеграции Heli

Попробуйте Heli

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

Создать аккаунтВойти

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

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