title: "Гайд по RikkaHub: как правильно настроить APIYI и избежать ошибок с /v1 и /v1beta"
date: 2024-05-22
tags: [AI, RikkaHub, APIYI, Android, LLM]
Примечание автора: RikkaHub — это Android-клиент с поддержкой множества больших языковых моделей. В этой статье мы на примере APIYI подробно разберем процесс подключения стороннего сервиса-прокси API, уделив особое внимание различиям между типами каналов /v1 и /v1beta и типичным ошибкам пользователей.
Использование больших языковых моделей на смартфоне больше не требует постоянного переключения между приложениями ChatGPT, Gemini и Claude. RikkaHub — это нативный Android-клиент для LLM, который позволяет подключать все основные модели через сторонние сервисы-прокси API. Однако многие пользователи сталкиваются с проблемой при настройке: один и тот же API-ключ отлично работает со всеми моделями в десктопном Cherry Studio, но в RikkaHub «заводятся» только модели Google, а GPT и Claude — нет.
Проблема кроется в типе канала — различии между /v1 и /v1beta. В этой статье мы на примере APIYI разберем все нюансы настройки.
Основная ценность: после прочтения вы научитесь правильно настраивать сервис-прокси APIYI в RikkaHub, поймете разницу между /v1 и /v1beta и сможете вызывать любые модели Claude, GPT и Gemini из одного приложения.
Основные моменты подключения RikkaHub к APIYI
| Пункт | Описание | Важность |
|---|---|---|
| Тип канала | /v1 для всех моделей, /v1beta только для Gemini | Критически важно |
| Base URL | https://vip.apiyi.com/v1 |
Следите за путем в конце |
| API-ключ | Получается на платформе APIYI | Один ключ для всех моделей |
| Выбор модели | Ввод вручную или выбор из списка | Настраивается по необходимости |
| Способ настройки | Создавайте отдельный Provider для каждого типа канала | Лучшая практика |
Что такое RikkaHub
RikkaHub — это клиент для общения с LLM с открытым исходным кодом для Android. Он написан на Kotlin + Jetpack Compose и использует язык дизайна Material You. Его главная фишка — поддержка подключения нескольких AI-провайдеров в одном приложении с возможностью свободного переключения между моделями прямо в процессе диалога.
| Основная информация | Детали |
|---|---|
| Репозиторий | github.com/rikkahub/rikkahub |
| Последняя версия | v2.1.7 (28.03.2026) |
| Поддерживаемые платформы | Android + Web |
| Поддерживаемые API | Совместимость с OpenAI, нативный Google Gemini, совместимость с Anthropic |
| Ключевые функции | Переключение моделей, мультимодальный ввод, поиск, поддержка MCP |
| Установка | Google Play / GitHub Release / Скачивание с сайта |
Среди ключевых особенностей RikkaHub:
- Мультимодальный ввод: поддержка изображений, PDF и DOCX-файлов
- Ветвление сообщений: возможность исследовать разные варианты ответов в одном диалоге
- Интеграция поиска: встроенные поисковики Exa, Tavily, Brave и другие
- Поддержка MCP: совместимость с протоколом Model Context Protocol
- Рендеринг Markdown: подсветка кода, формулы LaTeX, диаграммы Mermaid
- Импорт карточек персонажей: совместимость с карточками SillyTavern
Полное руководство по настройке APIYI в RikkaHub
Шаг 1: Получение API-ключа APIYI
Сначала получите API-ключ на платформе APIYI:
- Перейдите на сайт APIYI apiyi.com и зарегистрируйте аккаунт
- Зайдите в панель управления и создайте API-ключ
- Скопируйте и сохраните ключ (формат похож на
sk-xxxxxxxx)
Шаг 2: Добавление Provider в RikkaHub
Откройте RikkaHub → Настройки → AI Provider → Добавить новый Provider:
Настройка канала с совместимостью OpenAI (рекомендуется для всех моделей):
| Параметр | Что вписать | Примечание |
|---|---|---|
| Тип Provider | OpenAI Compatible | Выберите совместимость с OpenAI |
| Base URL | https://vip.apiyi.com/v1 |
В конце должен быть /v1 |
| API-ключ | Ваш ключ APIYI | sk-xxxxxxxx |
| Название модели | По желанию | Например, claude-sonnet-4-20250514 |
Шаг 3: Выбор модели и начало диалога
После настройки просто выберите нужную модель в интерфейсе чата. Благодаря унифицированному интерфейсу APIYI, в RikkaHub вы можете использовать:
- Семейство Claude: claude-sonnet-4, claude-opus-4 и др.
- Семейство GPT: gpt-5.4, gpt-5.4-mini и др.
- Семейство Gemini: gemini-2.5-pro, gemini-2.5-flash и др.
- Открытые модели: Llama 4, DeepSeek и др.
🎯 Быстрый старт: Получив API-ключ на APIYI apiyi.com, вам достаточно добавить один Provider в RikkaHub, чтобы свободно переключаться между всеми популярными AI-моделями прямо на телефоне.
Разбор типов каналов /v1 и /v1beta: критически важные различия в настройках
Почему один и тот же ключ не работает для некоторых моделей в RikkaHub
Это самая частая проблема, с которой сталкиваются пользователи RikkaHub:
«Почему с тем же токеном и API на компьютере в Cherry Studio всё работает, а на Android в RikkaHub я могу использовать только Google, а GPT и Claude — нет?»
Основная причина: в RikkaHub есть два типа каналов. Если выбрать неверный, часть моделей станет недоступной.
Ключевые различия между /v1 и /v1beta
| Характеристика | /v1 (совместим с OpenAI) | /v1beta (родной Gemini) |
|---|---|---|
| Совместимые модели | Claude + GPT + Gemini + Open Source | Только серия Gemini |
| Формат API | OpenAI Chat Completions | Родной формат Google Gemini |
| Пример Base URL | https://vip.apiyi.com/v1 |
https://vip.apiyi.com/v1beta |
| Сценарий использования | Универсальный, рекомендуется по умолчанию | Для специфических функций Gemini |
| Совместимость с моделями Google | Хорошая | Идеальная |
Преимущества и ограничения /v1beta
/v1beta — это родной формат API для Google Gemini. Когда вы выбираете путь /v1beta, RikkaHub использует оригинальный формат запросов Gemini (а не формат, совместимый с OpenAI) для связи с сервером.
Преимущества:
- Максимальная совместимость с моделями Gemini.
- Поддержка специфических функций Gemini (например, Grounding, настройки безопасности).
- Более «родной» формат ответа без промежуточных преобразований.
Ограничения:
- Работает только с моделями серии Gemini.
- Модели не от Google (Claude, GPT и др.) будут недоступны.
- Из-за различий в формате запросов попытка обращения к Claude/GPT приведет к ошибке.
Правильные варианты настройки
Вариант А: используйте только /v1 (рекомендуется большинству пользователей)
Если вы в основном используете комбинацию Claude, GPT и Gemini, просто создайте одного провайдера, совместимого с OpenAI:
Тип провайдера: OpenAI Compatible
Base URL: https://vip.apiyi.com/v1
API-ключ: sk-your-apiyi-key
Эта конфигурация позволяет вызывать все модели на APIYI, включая Gemini.
Вариант Б: два провайдера /v1 + /v1beta (для продвинутых пользователей)
Если вы хотите добиться наилучшей совместимости для моделей Gemini, можно создать двух провайдеров:
| Провайдер | Тип | Base URL | Назначение |
|---|---|---|---|
| Провайдер 1 | OpenAI Compatible | https://vip.apiyi.com/v1 |
Claude / GPT / Open Source |
| Провайдер 2 | Gemini | https://vip.apiyi.com/v1beta |
Серия Gemini (лучшая совместимость) |
Оба провайдера используют один и тот же API-ключ APIYI, а при общении вы просто выбираете нужного провайдера в зависимости от модели.
💡 Совет: если вы создали провайдера только типа
/v1beta, то работать будут только модели Gemini. Именно поэтому многие пользователи жалуются, что «работает только Google». Решение — создать дополнительного провайдера типа/v1или просто использовать/v1как единственный вариант.
Примеры конфигурации популярных моделей в RikkaHub
Таблица популярных моделей для RikkaHub
Ниже приведены настройки моделей, которые чаще всего используются в RikkaHub через APIYI:
| Модель | ID модели | Тип канала | Рекомендуемое использование |
|---|---|---|---|
| Claude Sonnet 4 | claude-sonnet-4-20250514 | /v1 | Повседневные диалоги, анализ |
| Claude Opus 4 | claude-opus-4-20250514 | /v1 | Сложные логические задачи |
| GPT-5.4 | gpt-5.4 | /v1 | Универсальный флагман |
| GPT-5.4 Mini | gpt-5.4-mini | /v1 | Легкая и быстрая |
| Gemini 2.5 Pro | gemini-2.5-pro | /v1 или /v1beta | Длинный контекст |
| Gemini 2.5 Flash | gemini-2.5-flash | /v1 или /v1beta | Быстрый отклик |
| DeepSeek V3 | deepseek-chat | /v1 | Эффективные вычисления |
| Llama 4 Maverick | meta-llama/llama-4-maverick | /v1 | Топовая Open Source модель |
Продвинутые настройки RikkaHub
Пользовательские HTTP-заголовки: RikkaHub поддерживает кастомные заголовки запросов, если вам нужно передать дополнительные параметры:
Headers:
X-Custom-Header: your-value
Импорт/экспорт через QR-код: Вы можете генерировать QR-коды для конфигураций провайдеров, чтобы делиться ими с друзьями или синхронизировать настройки между устройствами.
Переменные в промптах: Поддерживается использование переменных в системных промптах, таких как {model} (имя текущей модели) и {timestamp} (временная метка).
🚀 Совет по эффективности: Благодаря единому интерфейсу APIYI (apiyi.com) вам нужен всего один API-ключ, чтобы свободно переключаться между всеми популярными моделями: Claude, GPT, Gemini, DeepSeek и другими прямо в RikkaHub. Используйте функцию ветвления диалогов в RikkaHub, чтобы быстро сравнивать качество ответов разных моделей.
Сравнение RikkaHub с другими AI-клиентами для Android
| Параметр сравнения | RikkaHub | ChatGPT App | Gemini App | Claude App |
|---|---|---|---|---|
| Поддержка моделей | Все модели | Только GPT | Только Gemini | Только Claude |
| Кастомный API | Поддерживается | Нет | Нет | Нет |
| Сторонний сервис-прокси API | Поддерживается | Нет | Нет | Нет |
| Open Source | Да | Нет | Нет | Нет |
| Поддержка MCP | Да | Нет | Нет | Нет |
| Интеграция поиска | Несколько движков | ChatGPT Search | Нет | |
| Цена | Бесплатно | Подписка | Подписка | Подписка |
Главное преимущество RikkaHub — это одно приложение для всех AI-моделей. В связке с таким сервисом-прокси API, как APIYI, вам больше не нужно платить отдельно каждому провайдеру и устанавливать множество разных приложений.
🎯 Совет по выбору: Если вы пользуетесь услугами только одного AI-провайдера (например, только ChatGPT), официальное приложение будет удобнее. Но если вы, как и большинство разработчиков, часто переключаетесь между разными моделями, то связка RikkaHub + APIYI (apiyi.com) — самое гибкое решение на Android.
Устранение неполадок при подключении RikkaHub к APIYI
Распространенные ошибки и способы их решения
| Проблема | Причина | Решение |
|---|---|---|
| Работает только Gemini, остальные выдают ошибку | Выбран тип канала /v1beta | Измените на /v1 или создайте новый провайдер, совместимый с OpenAI |
| Все модели выдают ошибку | Ошибка в Base URL | Убедитесь, что указан https://vip.apiyi.com/v1 |
| Ошибка аутентификации | Неверный или просроченный API-ключ | Проверьте статус ключа в панели управления APIYI |
| Модель не найдена | Ошибка в написании ID модели | Сверьтесь с документацией APIYI для уточнения ID модели |
| Некорректный формат ответа | Несоответствие типа канала и модели | Для Gemini используйте /v1beta, для остальных — /v1 |
Часто задаваемые вопросы
Q1: Что выбрать: /v1 или /v1beta?
В большинстве случаев выбирайте /v1. Формат /v1 совместим с OpenAI и поддерживает все модели (включая Gemini). /v1beta — это нативный формат Gemini, он поддерживает только модели Gemini, но обеспечивает лучшую совместимость с ними. Если вы в основном используете Claude и GPT, выбирайте /v1. Если вам нужен лучший опыт работы с Gemini, можно создать два провайдера и настроить их по отдельности. Оба канала будут работать с одним и тем же ключом от APIYI (apiyi.com).
Q2: Что делать, если в Cherry Studio всё работает, а в RikkaHub нет?
Самая частая причина — неверная настройка типа канала. Cherry Studio по умолчанию использует формат, совместимый с OpenAI (/v1). Если в RikkaHub вы выбрали тип Gemini (/v1beta), модели не от Google работать не будут. Решение: создайте новый провайдер типа "OpenAI Compatible" и укажите Base URL https://vip.apiyi.com/v1.
Q3: RikkaHub бесплатный?
Само приложение RikkaHub бесплатно и имеет открытый исходный код. Однако за вызов моделей AI взимается плата. Вы получаете API-ключ на платформе APIYI (apiyi.com) и платите только за фактическое использование — никаких ежемесячных платежей или подписок. По сравнению с оплатой подписок на ChatGPT Plus ($20/мес), Claude Pro ($20/мес) и Gemini Advanced ($19.99/мес), модель оплаты по факту использования через APIYI + RikkaHub обычно выходит гораздо выгоднее.
Резюме
Основные моменты интеграции стороннего сервиса-прокси API в RikkaHub:
- Тип канала имеет значение:
/v1совместим со всеми моделями (Claude/GPT/Gemini/Open Source), в то время как/v1betaпредназначен только для Gemini, но обеспечивает лучшую совместимость именно с моделями от Google. - Рекомендуемая схема с двумя провайдерами: используйте
/v1как универсальный канал и/v1betaкак выделенный канал для Gemini. При этом можно использовать один и тот же API-ключ от APIYI. - Одно приложение для всего: RikkaHub + APIYI (apiyi.com) позволяют свободно переключаться между Claude, GPT, Gemini и другими моделями прямо на Android.
Больше не нужно прыгать между тремя-четырьмя разными AI-приложениями. Рекомендуем получить API-ключ на сайте APIYI (apiyi.com) — один ключ покроет все популярные модели. Используйте его вместе с RikkaHub, чтобы превратить свой смартфон в универсального AI-ассистента.
📚 Справочные материалы
-
Репозиторий RikkaHub на GitHub: исходный код и загрузка последних версий
- Ссылка:
github.com/rikkahub/rikkahub - Описание: содержит полный исходный код, релизы для скачивания и описание функций.
- Ссылка:
-
Официальная документация RikkaHub: настройка провайдеров и руководство пользователя
- Ссылка:
docs.rikka-ai.com - Описание: содержит подробные инструкции по настройке различных провайдеров.
- Ссылка:
-
Центр документации APIYI: получение API-ключа и список моделей
- Ссылка:
docs.apiyi.com - Описание: содержит ID всех поддерживаемых моделей, тарифы и примеры вызовов.
- Ссылка:
Автор: Техническая команда APIYI
Техническое обсуждение: Делитесь своим опытом настройки RikkaHub в комментариях. Больше материалов по интеграции AI-моделей можно найти в центре документации APIYI по адресу docs.apiyi.com.
