Dify
Dify может вызывать OdiRouter через OpenAI-API-совместимого провайдера моделей. Используйте это для чат-приложений, агентов и рабочих процессов Dify, которым нужны LLM-модели OdiRouter.
Требования
Заголовок раздела «Требования»| Требование | Значение |
|---|---|
| Dify | Облачный или self-hosted workspace с доступом к настройкам провайдеров моделей |
| Тип провайдера | OpenAI-API-compatible |
| API endpoint | https://www.odirouter.ai/v1 |
| API Key | API key OdiRouter |
| Имя модели | ID LLM-модели в OdiRouter |
Добавьте провайдера OdiRouter
Заголовок раздела «Добавьте провайдера OdiRouter»- Откройте Dify.
- Перейдите в настройки провайдеров моделей.
- Добавьте провайдера типа
OpenAI-API-compatible. - Укажите API endpoint или Base URL
https://www.odirouter.ai/v1. - Вставьте API key OdiRouter.
- Добавьте ID модели OdiRouter, например
gpt-5.5. - Сохраните и протестируйте провайдера.
Используйте в приложении
Заголовок раздела «Используйте в приложении»- Откройте приложение Dify.
- Перейдите в настройки модели.
- Выберите провайдера OdiRouter.
- Выберите настроенную модель.
- Запустите короткий тестовый prompt.
Ответь одним предложением и подтверди, что Dify использует OdiRouter.Чтение LLM-вывода
Заголовок раздела «Чтение LLM-вывода»Когда Dify вызывает OdiRouter как LLM-провайдера, узел приложения обычно передает текст модели как свой output в следующие узлы. Если вы вызываете chat completions напрямую через HTTP request node, текст ассистента находится по пути:
choices[0].message.contentВ workflow сохраните это поле в понятную переменную, например answer, summary или model_output, а затем передавайте ее в условия, шаблоны, запись в базу данных или webhook response.
Рабочие процессы multimodal queue
Заголовок раздела «Рабочие процессы multimodal queue»Для асинхронных image, video, audio или 3D models используйте HTTP request capability Dify:
| Шаг | Endpoint |
|---|---|
| Создать задачу | POST https://www.odirouter.ai/model/v1/queue/{endpoint} |
| Проверить статус | GET {status_url} |
| Получить результат | GET {response_url} |
После создания задачи сохраните поля:
| Поле | Назначение |
|---|---|
request_id | ID задачи для логов, диагностики и связи с бизнес-объектом |
status_url | Передается в цикл или HTTP-узел для проверки статуса |
response_url | Используется для получения результата после завершения |
Опросите status_url, пока status не станет COMPLETED, затем вызовите response_url. Структура финального результата зависит от типа модели и обычно содержит URL изображения, видео, аудио, 3D-файла или текстовые поля. Сопоставьте нужный URL или текст с переменной workflow перед передачей дальше.
Диагностика
Заголовок раздела «Диагностика»| Симптом | Исправление |
|---|---|
| Тест провайдера возвращает 401 | Создайте новый API key OdiRouter |
| Model not found | Добавьте точный ID модели из /models |
| Dify просит полный OpenAI endpoint | Обычно используйте https://www.odirouter.ai/v1, если Dify явно не просит полный chat endpoint |
| Multimodal-модель не работает в LLM-провайдере | Используйте HTTP workflow nodes и /model/v1/queue/{endpoint} API |