Настройка RikkaHub
RikkaHub — открытый нативный ИИ-чат для Android в стиле Material You. Поддерживает собственные OpenAI / Google / Anthropic-совместимые эндпоинты, а также MCP, веб-поиск, память и мультимодальный ввод.
Предварительные требования
- Аккаунт OfoxAI и API Key (получить здесь )
- RikkaHub, установленный на Android-телефоне (скачать с официального сайта или Google Play )
Выбор протокола
В RikkaHub есть три типа поставщиков — OpenAI, Google и Claude. Все три подходят для подключения OfoxAI:
Из материкового Китая можно использовать зеркальный домен api.ofox.io — пути те же, API Key общий. На скриншотах ниже использован именно зеркальный адрес.
Настройка протокола OpenAI
Шаг 1: Открыть настройки
Откройте левую боковую панель RikkaHub и нажмите значок Настройки в правом нижнем углу.
Шаг 2: Перейти в раздел «Провайдеры»
На странице настроек в группе Модели и службы нажмите Провайдеры.
Шаг 3: Добавить поставщика
Нажмите + в правом верхнем углу, чтобы создать нового поставщика.
Шаг 4: Заполнить данные конфигурации
Выберите тип OpenAI, заполните поля ниже и нажмите Сохранить:
RikkaHub напрямую склеивает Базовый URL API и Путь API в адрес запроса. Не ставьте слеш в конце Base URL и не добавляйте /chat/completions. При выключенном API ответов путь по умолчанию — /chat/completions, и доступны все модели OfoxAI; при включённом используется рекомендуемый OfoxAI Responses API, у которого нативный Prompt Caching работает эффективнее.
Шаг 5: Добавить модели
Перейдите на вкладку Модели внизу. RikkaHub автоматически загрузит каталог моделей OfoxAI, и модели можно просто отметить в списке Доступные модели. Также можно нажать Добавить новую модель и ввести ID модели вручную, например openai/gpt-6-luna.
ID модели должен содержать префикс вендора: указывайте openai/gpt-6-luna, а не просто gpt-6-luna. Полный каталог — на маркетплейсе моделей .
Шаг 6: Проверить подключение
Вернитесь на вкладку Настроить, нажмите значок вилки в левом нижнем углу, чтобы открыть Проверить подключение, выберите модель и нажмите Тест. Если напротив Без стриминга, Стриминг и Вызов инструмента появились зелёные галочки, настройка выполнена успешно.
Настройка протокола Claude (рекомендуется для моделей Claude)
Для моделей серии Claude рекомендуется нативный протокол Anthropic: он даёт полный набор возможностей и преимущества нативного кэширования.
Шаг 1: Создать поставщика типа Claude
Повторите шаги 1–3 выше и создайте ещё одного поставщика (например, назовите его ofox-claude) — так протоколы OpenAI и Claude можно использовать одновременно. Выберите тип Claude, заполните поля ниже и нажмите Сохранить:
Base URL для типа Claude обязательно должен содержать /v1. RikkaHub сам добавляет в конец /messages; если пропустить /v1, запрос уйдёт на /anthropic/messages и вернётся 404.
Шаг 2: Добавить модель и проверить
На вкладке Модели добавьте модель Claude (например, anthropic/claude-sonnet-5.5), вернитесь на вкладку Настроить, нажмите значок вилки и проверьте подключение — все три пункта должны получить зелёные галочки.
Настройка протокола Gemini (рекомендуется для моделей Gemini)
Для моделей Gemini рекомендуется нативный протокол Gemini.
Шаг 1: Создать поставщика типа Google
Повторите шаги 1–3 выше и создайте ещё одного поставщика (например, назовите его ofox-gemini). Выберите тип Google, заполните поля ниже и нажмите Сохранить:
По умолчанию API Base Url типа Google указывает на официальный адрес Google. Обязательно замените его на https://api.ofox.io/gemini/v1beta (с /v1beta, без завершающего слэша). RikkaHub сам добавляет в конец /models/<ID модели>:generateContent. Переключатель Vertex AI оставьте выключенным.
Шаг 2: Добавить модель и проверить
На вкладке Модели добавьте модель Gemini (например, google/gemini-3.8-flash, с префиксом google/), вернитесь на вкладку Настроить, нажмите значок вилки и проверьте подключение — все три пункта должны получить зелёные галочки.
Рекомендуемые модели
Начало работы
Вернитесь на страницу чата, найдите в селекторе моделей только что добавленного поставщика OfoxAI и выберите модель — можно начинать диалог. MCP, веб-поиск, мультимодальный ввод и другие функции RikkaHub работают с моделями OfoxAI.
Часто задаваемые вопросы
В: При проверке подключения нет моделей для выбора
Проверка подключения позволяет выбрать только модели, уже добавленные у текущего поставщика. Сначала добавьте хотя бы одну модель на вкладке Модели, затем вернитесь на страницу Настроить и проверьте.
В: Поставщик типа Claude возвращает 404 при проверке
Убедитесь, что API Base Url не записан как https://api.ofox.io/anthropic без завершающего /v1. Правильное значение — https://api.ofox.io/anthropic/v1.
В: Сообщение о недействительном API Key
Убедитесь, что API Key скопирован из консоли OfoxAI полностью и в начале и конце нет лишних пробелов.
В: Сообщение, что модель не существует
В ID модели отсутствует префикс вендора. Формат ID моделей OfoxAI — вендор/название модели, например openai/gpt-6-luna, anthropic/claude-sonnet-5.5.
В: Не удаётся подключиться из материкового Китая
Замените API Base Url на зеркальный адрес: для типа OpenAI — https://api.ofox.io/v1, для типа Claude — https://api.ofox.io/anthropic/v1; API Key общий.