Как подключить Dify к API429

Проверьте провайдер и версию плагина

В настройках провайдеров моделей вашей рабочей области Dify найдите официальный OpenAI-API-compatible и добавьте пользовательскую LLM-модель. Сверенные исходники main на дату проверки содержат версию плагина 0.0.69; это не утверждение о версии, установленной у вас. Сопоставьте доступные поля со схемой вашего плагина перед вводом секрета. Если необходимые переключатели отсутствуют, сначала выясните различия версий, а не выбирайте похожий режим наугад.

Начальная задача — один обычный текстовый ответ, без подключённой базы знаний и инструментов. Провайдер перечисляет разные типы моделей, но наличие пункта в его интерфейсе не доказывает совместимость API429 с каждым из них. Этот маршрут не подтверждает Agents, RAG, embeddings, Responses или обработку медиа. Такие задачи требуют отдельного подбора модели, метода и проверки фактического запроса.

Заполните адрес, модель и секрет

В secret-input api_key введите свой ключ API429 через предусмотренную форму. Поле endpoint_url содержит https://gateway.api429.com/v1, а endpoint_model_name — точный gemini-3.8-flash. Не путайте отправляемое имя модели с произвольной подписью для рабочего пространства. Подтвердите наличие ID в публичном каталоге, а доступ конкретного ключа отдельно проверьте авторизованным GET /v1/models. Секрет не включайте в журналы, снимки или экспортируемую инструкцию.

Выберите mode:chat и api_type:chat_completions. Для token_param_name задайте max_tokens явно, не оставляя решение автоматическому распознаванию имени. compatibility_mode:strict оставляет выбранный совместимый режим без добавления расширенных параметров. Ожидаемый маршрут — https://gateway.api429.com/v1/chat/completions. Не выбирайте Responses и не добавляйте параметры размышления или инструментов только потому, что плагин умеет их отображать.

Установите консервативные локальные ограничения

В листе ниже context_size равно 4096, а max_tokens_to_sample равно 256. Это локальные настройки приложения для первого небольшого текста, не предел модели и не паспортные характеристики Gemini. Первое значение ограничивает представление приложения о доступном контексте, второе задаёт верхнюю границу настраиваемого ответа. Для пробного чата также установите фактический параметр ответа max_tokens равным 256; не считайте одну запись в форме доказательством тела любого последующего запроса.

JSON ниже — памятка значений полей формы, а не импортируемый файл приложения или полная конфигурация Dify. YOUR_API429_KEY остаётся буквальной заглушкой, пока вы не вводите реальный секрет в защищённое поле. Локальные пределы выбираются осторожно для первого шага; для длинной истории их пересматривают по проверенным характеристикам модели и фактическому запросу. Увеличение числа в интерфейсе само по себе не предоставляет дополнительных возможностей сервису.

Сохранение и проверка могут создавать расход

Save/Test может выполнять платную генерацию. Это не бесплатная офлайн-проверка синтаксиса или ключа: реализация validate_credentials обращается к модели и содержит fallback-попытки при некоторых ошибках параметров. Поэтому сначала сопоставьте поля и доступ, затем выполните проверку осознанно один раз. При ошибке изучите её тип без вывода секрета; не нажимайте кнопку снова автоматически и не обещайте отсутствие повторных обращений.

После успешного сохранения выберите модель в простом новом текстовом приложении, без знаний и инструментов, и отправьте короткий несекретный вопрос. Для первого ответа используйте непотоковый режим, если он доступен в выбранном интерфейсе вашей версии. Сравните полученный текст, выбранный ID и расход в кабинете API429. Проверка формы и первый диалог — разные действия, каждое из которых может обращаться к модели.

Рабочая область и общий бюджет

Определите, кто в рабочей области вправе использовать сохранённый ключ и созданное приложение. Общий секрет провайдера не становится отдельным личным ключом каждого сотрудника. Разграничение доступа и правила запуска настраивает владелец рабочей области средствами своего приложения. max_tokens ограничивает один ответ, но не устанавливает общий бюджет: входной контекст, число обращений, проверки и fallback влияют на общую стоимость. Текущие ставки и единицы оплаты смотрите в карточке модели и тарифном сравнении; здесь описана настройка клиента, а не гарантия фиксированного расхода.

Лист полей формы OpenAI-API-compatible; не импорт Dify

{
  "api_key": "YOUR_API429_KEY",
  "endpoint_url": "https://gateway.api429.com/v1",
  "endpoint_model_name": "gemini-3.8-flash",
  "mode": "chat",
  "api_type": "chat_completions",
  "token_param_name": "max_tokens",
  "compatibility_mode": "strict",
  "context_size": "4096",
  "max_tokens_to_sample": "256"
}

Контрольный обычный текстовый контракт; не файл приложения Dify

{
  "model": "gemini-3.8-flash",
  "messages": [
    {
      "role": "user",
      "content": "Ответь одним предложением: что такое API?"
    }
  ],
  "max_tokens": 256,
  "stream": false
}

Оплата и тест $10

• Карта российского банка. Пополнение баланса в личном кабинете.
• Счёт для юрлиц. Безналичная оплата с закрывающими документами.
• USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте