Перейти к основному содержимому

RikkaHub с OpenCheese

/ Документация API

← Быстрый старт с APIОткрыть как Markdown

RikkaHub — чат-приложение для Android, которое работает с OpenCheese через любой из двух своих типов провайдеров: OpenAI — для всех моделей или Claude — формат Anthropic для моделей Claude.

Добавьте провайдер

Откройте боковую панель, нажмите Настройки (Settings), затем Провайдеры (Providers) в группе «Модели и службы» (Models & Services) и нажмите +.

Для типа OpenAI:

Поле Значение
Имя (Name) OpenCheese (любое имя)
Ключ API (API Key) ваш API-ключ OpenCheese
Базовый URL API (API Base Url) https://api.opencheese.dev/v1
Путь API (API Path) /chat/completions (по умолчанию)
API ответов (Response API) выключено; или включено вместе с настройкой ассистента Потоковый вывод (Stream Output), см. ниже

Для типа Claude:

Поле Значение
Имя (Name) OpenCheese Claude (любое имя)
Ключ API (API Key) ваш API-ключ OpenCheese
Базовый URL API (API Base Url) https://api.opencheese.dev/v1

В обоих типах базовый URL содержит /v1: RikkaHub сам добавляет /chat/completions, /responses, /messages или /models. Слеш в конце не ставьте.

Сохраните, откройте вкладку Модели (Models) и выберите модели из списка, который загрузит RikkaHub, а затем проверьте их через значок штекера — Проверить подключение (Test Connection).

Чтобы увидеть тот же список с компьютера и заодно проверить ключ:

bash
curl -s https://api.opencheese.dev/v1/models \
  -H "Authorization: Bearer $OPENCHEESE_API_KEY" | jq -r '.data[].id'

Выберите быструю модель

Названия разговоров и подсказки ответов RikkaHub создаёт моделью из настройки Быстрая модель (Fast Model). Сразу после установки эта настройка не указывает ни на одну реальную модель, и RikkaHub, прежде чем что-либо отправить, показывает «Быстрая модель не найдена. Пожалуйста, выберите её в настройках.» («Fast model not found. Please select one in settings.»). Откройте Настройки → Модель и промпт по умолчанию (Settings → Default Model and Prompt) и в пункте Быстрая модель выберите текстовую модель OpenCheese; хватит дешёвой или бесплатной. Если для вас важна стоимость подсказок на каждой реплике, отключите их.

Уровни рассуждений

Уровень рассуждений, выбранный в чате, отправляется вместе с запросом. Выберите один из уровней, которые модель перечисляет в supported_reasoning_levels (см. Модели), или Авто (Auto), чтобы действовал уровень модели по умолчанию. Уровень, которого у модели нет, отклоняется с сообщением, где перечислены доступные уровни.

Модели изображений

RikkaHub показывает модели изображений и в списке моделей чата, а в чате они отвечают изображением:

  • Добавьте модель изображений с типом Чат (Chat) и режимом ввода Текст + Изображение (Text + Image). RikkaHub не знает ID этих моделей и иначе считает их чисто текстовыми: каждое отправленное вами изображение превращается в текст, и вместо правок получаются новые изображения.
  • С API ответов (Response API) держите включённой настройку ассистента Потоковый вывод (Stream Output): ответ с изображением, пришедший не потоком, RikkaHub показывает как ошибку.
  • Режим Chat Completions работает и с потоковым ответом, и без него.
  • Для страницы изображений RikkaHub добавьте ту же модель ещё раз с типом Изображение (Image) и количеством изображений 1. В одной правке принимается до 5 референсных изображений.

Фоновый вызов, направленный на модель изображений (например, для названия или подсказки), отклоняется с сообщением, в котором названа настройка Fast Model, поэтому изображение никогда не оплачивается по ошибке.

Расход

Каждый разговор RikkaHub вместе с его названиями, подсказками и сводками отображается в панели на странице Транзакции как одна сессия. Каждое изображение со страницы изображений — отдельная сессия.

В сыре есть дырки. В вашей инфраструктуре их быть не должно.