Руководство по интеграции RisuAI

Обзор

Слот Custom Models в RisuAI позволяет вставить Request URL, ключ API и ID модели. Подводный камень: переключатель Autofill Request URL; когда он включён, RisuAI переписывает вставленный URL, молча ломая подключение.

Быстрая настройка

Скопируйте эти три значения в поля Custom Models в Advanced Settings RisuAI.

Request URL: https://api.unorouter.ai/v1/chat/completions
Ключ API:    YOUR_API_KEY
ID модели:   claude-opus-4-5

Вставьте полный URL, оканчивающийся на `/v1/chat/completions`. В режиме Custom Models у RisuAI нет выпадающего списка моделей; Model ID задаётся вручную в текстовом поле.

Пошаговая настройка

1. 1
   Откройте Advanced Settings

   В RisuAI откройте Settings, затем Advanced Settings.

2. 2
   Выберите слот модели

   Нажмите селектор модели Chat Bot, прокрутите до конца списка и выберите Custom Models.

3. 3
   Снимите флажок Autofill Request URL

   Этот переключатель должен быть ВЫКЛЮЧЕН до того, как вы что-либо вставите. См. критическое предупреждение выше.

4. 4
   Вставьте Request URL

   Вставьте полный URL, оканчивающийся на `/v1/chat/completions`.

5. 5
   Вставьте ключ API

   Вставьте ваш ключ API UnoRouter в поле API Key. В некоторых сборках RisuAI это поле называется Authorization; используйте его, если поле API Key отсутствует.

6. 6
   Вставьте Model ID

   Введите или вставьте точное имя модели со страницы моделей UnoRouter.

7. 7
   Сохраните

   Закройте панель настроек; RisuAI запишет конфигурацию в локальное хранилище.

8. 8
   Отправьте тестовое сообщение

   Откройте любой чат и отправьте тестовое сообщение, чтобы проверить ответ.

Почему важен переключатель автозаполнения

Autofill Request URL был добавлен, чтобы предотвратить опечатки у именованных пресетов провайдеров. Для Custom Models он превращается в ловушку: RisuAI переписывает ваш пользовательский URL на значение по умолчанию, которое не указывает на нас. Если обновление RisuAI снова включит этот переключатель, повторите шаг 3, прежде чем отлаживать что-либо ещё.

Настройте Auxiliary Model

RisuAI использует второй слот модели для задач перевода, суммирования и угадывания имён. Повторите шаги со 2 по 7 для селектора Auxiliary Model, используя тот же URL и ключ UnoRouter.

Устранение неполадок

• 404 или «Invalid URL». Autofill Request URL был включён во время вставки; RisuAI переписал URL. Снимите флажок и вставьте Request URL заново.
• Работало раньше, теперь нет ответа. Обновление RisuAI может молча снова включить Autofill Request URL. Откройте Custom Models и убедитесь, что он по-прежнему выключен.
• 401 Unauthorized. В сборках RisuAI иногда доступны оба поля: API Key и Authorization; в зависимости от версии читается только одно. Переместите ключ в другое поле и повторите попытку.
• Модель не найдена. Model ID должен точно совпадать с именем модели. Скопируйте значение со страницы моделей UnoRouter, не вводите его заново вручную.
• Перевод или суммирование не работают. Auxiliary Model не настроен. Повторите настройку для слота Auxiliary Model.
• Потоковый вывод идёт кусками или теряет фрагменты. SSE-парсер RisuAI ожидает обычные события `data:`. Корпоративный прокси, срезающий этот префикс, приведёт к искажённому стримингу. Протестируйте в некорпоративной сети, если это возможно.
• Настройки сбрасываются после перезапуска браузера. RisuAI хранит конфигурацию в локальном хранилище браузера, которое очищается некоторыми режимами конфиденциальности. Экспортируйте конфигурацию в файл из Settings для резервного копирования.