Подключение BeatAPI к Dify

Dify — платформа LLMOps для создания чатов, агентов и рабочих процессов. Достаточно один раз добавить BeatAPI как поставщика моделей, после чего его можно выбирать в любом приложении рабочего пространства.

Описанная ниже настройка поставщика моделей не связана с плагином инструментов BeatAPI в Dify Marketplace. Сейчас в Marketplace представлена версия v0.1.0 с двумя инструментами для музыкального видео. Расширенный плагин v0.2.1 отправлен на проверку Marketplace. Подача заявки не подтверждает обновление версии в Marketplace или успешное выполнение каждого нового инструмента в рабочем пространстве Dify.

Что понадобится

Рабочее пространство Dify: облачный сервис или собственное развёртывание.
API-ключ BeatAPI: создайте его в Dashboard → API Keys.

Шаг 1. Откройте настройки моделей

Нажмите аватар справа вверху, выберите Settings, затем Model Provider в меню слева.

Шаг 2. Добавьте BeatAPI

Есть два способа получить один результат. Первый быстрее; второй позволяет отделить BeatAPI от остальных поставщиков.

Вариант A. Используйте поставщика OpenAI

Найдите поставщика OpenAI и нажмите Configure.
Заполните поля:

Поле	Значение
API Key	Ваш API-ключ BeatAPI
API Base URL	`https://api.beatapi.io/v1`

Сохраните настройки и включите нужные модели в списке.

Список моделей OpenAI принадлежит Dify и не загружается с указанного адреса API. Если включить модель, которую BeatAPI не предоставляет, приложение получит not_found при выполнении. Включайте только ID из таблицы ниже или со страницы цен.

Вариант B. Добавьте своего поставщика моделей

Найдите Custom Model и нажмите + Add Model.
Заполните поля:

Поле	Значение
Model Name	`BeatAPI` или другое название
Model Type	`LLM`
API Key	Ваш API-ключ BeatAPI
API endpoint URL	`https://api.beatapi.io/v1`
Endpoint model name	Точный ID модели, например `claude-sonnet-5`

Повторите настройку для каждой нужной модели. Полей потребуется заполнить больше, зато в списке будут только действительно работающие модели.

Шаг 3. Выберите модели

ID модели	Контекст	Для каких задач подходит
`claude-fable-5-1`	Длинный	Новое поколение для требовательных приложений
`claude-sonnet-5`	Длинный	Баланс качества и стоимости
`claude-haiku-4-5-20251001`	Длинный	Классификация, маршрутизация и другие недорогие шаги
`gpt-6-astra`	Длинный	Новое поколение OpenAI; тариф повышается при входе свыше 272K токенов
`gemini-3.7-flash`	Длинный	Быстрые и недорогие ответы
`deepseek-v4-pro-0813`	Длинный	Сложные рассуждения по невысокой цене
`minimax-m3`	Очень длинный	Документы, превышающие обычные ограничения контекста

Подробности приведены в разделе Text API, тарифы — на странице цен.

У некоторых моделей тариф зависит от нагрузки или длины контекста. Две модели DeepSeek HC (high-cache) удваивают тарифы по будням с 09:00 до 12:00 и с 14:00 до 18:00 по Пекину; обычные платные модели DeepSeek используют единый тариф круглосуточно. У Hunyuan hy3 своё ежедневное пиковое окно. У GPT-6 Astra и семейства GPT-5.6 тариф повышается при входе свыше 272K токенов, у Grok — свыше 200K. Запланированный рабочий процесс Dify может полностью попадать в пиковое окно незаметно для вас. См. примечания на странице цен.

Шаг 4. Создайте и опубликуйте приложение

Создайте приложение типа Chatbot, Text Generator, Agent или Workflow.
В Model Settings выберите модель BeatAPI.
Напишите системный промпт, используя {{variable}} для пользовательского ввода и {{context}} для содержимого базы знаний.
Проверьте приложение в панели предварительного просмотра и нажмите Publish, чтобы опубликовать его как API, встраиваемый виджет или общую ссылку.

Параметры, которые стоит настроить

Параметр	На что влияет	Рекомендуемое значение
Temperature	Случайность ответа	`0.7` для творчества, `0.3` для точных ответов
Max Tokens	Максимальная длина ответа	2000–4000
Top P	Выбор токенов по суммарной вероятности	`0.9`

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

Dify не подключается

Base URL должен быть https://api.beatapi.io/v1: с /v1, без завершающего слеша.
Убедитесь, что ключ активен, в Dashboard → API Keys.
При собственном развёртывании проверьте доступ сервера Dify к api.beatapi.io, а не только доступ из браузера.

Ошибка модели появляется только при выполнении

Модель включена в списке Dify, но недоступна аккаунту. Сверьте ID со страницей цен.

402 insufficient_credits

Баланс равен нулю или меньше стоимости запроса. Пополните его в панели управления. Пока средств нет, пользователи опубликованного приложения будут получать ошибки; настройте уведомление об этом.

429 rate_limit_exceeded

Ключ превысил лимит частоты запросов, возможно из-за параллельных ветвей рабочего процесса. Уменьшите параллелизм или увеличьте лимит. Минутный лимит растёт с общей суммой пополнений и отображается в панели управления.

Как контролировать расходы

Создайте отдельный ключ BeatAPI для каждого приложения, чтобы поле by_api_key в GET /v1/usage показывало расходы по приложениям.
Для классификации, маршрутизации и извлечения данных выбирайте недорогую модель, оставляя сильную модель для итогового ответа.
Ограничьте Max Tokens в каждом узле: значения по умолчанию могут быть слишком большими.

Поддержка

Создайте обращение в панели управления и укажите request_id из ответа с ошибкой.