> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

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

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

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

Описанная ниже настройка поставщика моделей не связана с [плагином инструментов BeatAPI в Dify Marketplace](https://marketplace.dify.ai/plugin/erickkkyt/beatapi). Сейчас в Marketplace представлена версия v0.1.0 с двумя инструментами для музыкального видео. Расширенный плагин v0.2.1 [отправлен на проверку Marketplace](https://github.com/langgenius/dify-plugins/pull/3164). Подача заявки не подтверждает обновление версии в Marketplace или успешное выполнение каждого нового инструмента в рабочем пространстве Dify.

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

1. **Рабочее пространство Dify**: облачный сервис или собственное развёртывание.
2. **API-ключ BeatAPI**: создайте его в [Dashboard → API Keys](https://beatapi.io/dashboard/apikeys).

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

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

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

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

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

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

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

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

> **Note**
>
> Список моделей OpenAI принадлежит Dify и не загружается с указанного адреса API. Если включить модель, которую BeatAPI не предоставляет, приложение получит `not_found` при выполнении. Включайте только ID из таблицы ниже или со [страницы цен](https://beatapi.io/pricing).

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

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

| Поле                | Значение                                     |
| ------------------- | -------------------------------------------- |
| 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](/text-api), тарифы — на [странице цен](https://beatapi.io/pricing).

> **Note**
>
> У некоторых моделей тариф зависит от нагрузки или длины контекста. Две модели 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 может полностью попадать в пиковое окно незаметно для вас. См. примечания на [странице цен](https://beatapi.io/pricing).

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

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

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

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

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

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

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

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

Модель включена в списке Dify, но недоступна аккаунту. Сверьте ID со [страницей цен](https://beatapi.io/pricing).

### 402 insufficient_credits

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

### 429 rate_limit_exceeded

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

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

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

## Поддержка

Создайте обращение в [панели управления](https://beatapi.io/dashboard) и укажите `request_id` из ответа с ошибкой.