Интеграции · проверено 2 августа 2026 г. · 10 минут
Подключение Celestria API к n8n, Dify и OpenWebUI
Во всех трёх инструментах нужен один и тот же набор: base URL https://api.celestriagate.com/v1, ключ Celestria Gate и точный ID модели из GET /models. Различается только место, где интерфейс позволяет задать custom OpenAI endpoint.
Общие параметры
| Поле | Значение |
|---|---|
| Base URL | https://api.celestriagate.com/v1 |
| API key | cg_live_… из кабинета |
| Model | например gpt-5.6-terra |
| Models endpoint | GET /models |
| Text endpoint | POST /responses или /chat/completions |
n8n
Создайте credential для OpenAI-compatible сервиса, если установленная версия n8n позволяет переопределить Base URL. Укажите ключ и https://api.celestriagate.com/v1, затем выберите модель вручную. Если конкретный AI node не показывает Base URL, используйте HTTP Request node и вызовите /responses напрямую.
Для надёжного workflow включите Continue On Fail только там, где ошибка AI не должна останавливать процесс. Ограничьте retries, иначе временный 429 может создать лавину повторных запросов.
Dify
В разделе Model Provider добавьте OpenAI-compatible или Custom provider, задайте Base URL, ключ и ID модели. Раздельно проверьте chat, tool calling и structured output: возможности зависят от выбранной модели и версии адаптера Dify.
Для knowledge base контролируйте объём извлечённых фрагментов. Избыточный top-k увеличивает контекст, цену и вероятность того, что модель отвлечётся на нерелевантные документы.
OpenWebUI
В Admin Settings откройте Connections и добавьте OpenAI API connection. Введите https://api.celestriagate.com/v1 и ключ, затем обновите список моделей. Для общей установки не раздавайте пользователям сам ключ — храните его в серверной конфигурации OpenWebUI.
Если модель не появилась, сначала вызовите GET /models через curl. Так можно отделить ошибку ключа или сети от кэша интерфейса OpenWebUI.
curl https://api.celestriagate.com/v1/models \
-H "Authorization: Bearer $CELESTRIA_API_KEY"Типовые ошибки
- 401 — неверный, отозванный или переданный без Bearer ключ.
- 402 — недостаточно средств или превышен бюджет.
- 404 model_not_found — ID модели не совпадает с GET /models.
- 429 — превышена частота; добавьте backoff и ограничьте concurrency.
- Пустой список моделей — проверьте Base URL: он должен заканчиваться на /v1.
Частые вопросы
Нужно ли ставить отдельный плагин?
Обычно нет: достаточно OpenAI-compatible подключения. Если конкретная версия инструмента не позволяет менять base URL, используйте универсальный HTTP Request node или обновите интеграцию.
Почему модель не отображается в списке?
Проверьте GET /models с тем же ключом, затем точность base URL и кэш интерфейса. Некоторые инструменты требуют ввести ID модели вручную.
Поддерживаются ли tools?
Celestria поддерживает function tools в ядре совместимого API, но итог зависит также от модели и адаптера n8n, Dify или OpenWebUI. Проверяйте на минимальном тестовом tool.