Альтернатива OpenRouter для Janitor AI: руководство по настройке

Что нужно ввести

Если вы хотите альтернативу OpenRouter для Janitor AI или аналогичного приложения для общения с персонажами, настройка такая же, как у любого поставщика, совместимого с OpenAI. Найдите в клиенте место для добавления пользовательского или прокси API. Разные приложения называют это по-разному: «proxy», «кастомный эндпоинт OpenAI», «URL API». Поля под ними всегда одинаковы и их всего три.

Поле	Значение
URL API / базовый URL	https://api.openrouterapi.cc/v1
API-ключ	Ключ из вашего аккаунта, отправляемый как Authorization: Bearer
Имя модели	uncensored

Некоторые клиенты требуют полный эндпоинт вместо базового. Если сохранение базового URL вызывает ошибку или 404, попробуйте https://api.openrouterapi.cc/v1/chat/completions. Поддерживаются два метода: POST /v1/chat/completions и GET /v1/models, поэтому клиент, отображающий модели, вызовет второй и увидит uncensored.

Если у вас еще нет ключа, зарегистрируйтесь через Google или по электронной почте и паролю и следуйте инструкциям по API-ключу. Новые аккаунты могут получить пробный баланс $0,50 в один клик, чего достаточно для первого тестового сеанса.

Проверьте соединение, прежде чем винить приложение

Фронтенды для ролевых игр скрывают исходный текст ошибки. Сначала выполните один запрос из терминала, чтобы убедиться, что ключ и модель работают. Замените заполнитель на свой ключ.

Copycurl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

Если ответ получен, эндпоинт и ключ в порядке, и проблема в настройках приложения. Если запрос не выполнен, тело ошибки объяснит причину. Сохраните идентификатор запроса из заголовка ответа X-Request-Id; он поможет при обращении в поддержку.

Стартовый системный промпт

Карточка персонажа во фронтенде обычно становится системным сообщением. Что бы ни делало ваше приложение, модель получает что-то вроде текста ниже. Модель настроена на ответы без отказов в контенте для законного использования взрослыми, поэтому промпт не должен спорить с ней. Он должен четко определять голос, границы и формат.

Вы — Мара Восс, главный инженер грузового судна «Коллоуэй».

Голос: сухой, практичный, склонный к шуткам в стрессовых ситуациях.

Пишите от третьего лица в прошедшем времени, по 2–4 коротких абзаца.

Никогда не говорите и не действуйте от имени персонажа пользователя.

Сохраняйте непрерывность: отслеживайте травмы, ремонты и кто что знает.

Оставайтесь в рамках истории. Все персонажи — взрослые.

Две привычки улучшают длинные сеансы. Во-первых, держите системный промпт коротким, так как он отправляется при каждом ходе. Во-вторых, помещайте жесткие правила в конец промпта, а не в середину, чтобы они оставались заметными при росте истории чата. Если ваше приложение позволяет добавить «авторскую заметку» или напоминание, вставляемое рядом с последним сообщением, используйте его для правил стиля.

Одно правило жестко зафиксировано в этом сервисе и в вашем промпте: отсутствие сексуального контента с участием несовершеннолетних. Запись этого в карточку персонажа также держит ваши карточки чистыми.

Настройки, которые обычно работают

Это отправные точки, а не гарантии. Меняйте по одному параметру и сравнивайте несколько ответов.

• Температура 0.8–1.0 для живого диалога. Установите значение около 0.6, если персонаж уходит в сторону или противоречит сам себе.
• top_p 0.9–0.95, если ваш клиент отображает этот параметр. Он передаётся напрямую.
• Штрафы за частоту и присутствие 0,2–0,5, если ответы начинают повторять фразы. Большие значения делают текст странным, поэтому держите значения низкими.
• max_tokens — необязательный параметр. Установите значение 300–600, если хотите ответы длиной с абзац, а не с эссе.
• Включена потоковая передача. Ответ появляется по мере написания, а последний фрагмент содержит данные об использовании, чтобы ваш клиент мог показывать количество токенов.
• seed передаётся напрямую, что удобно, когда вы хотите сравнить два варианта промпта в одной сессии.

Потоковая передача имеет один побочный эффект, о котором стоит знать: потоковый запрос удерживает слот параллельных запросов до завершения потока. Полный ключ позволяет 8 запросов одновременно и 300 в минуту. Пробный ключ позволяет 2 одновременно и 60 в минуту.

Контекст, память и стоимость длинных чатов

Контекстное окно составляет 100 000 токенов, включая промпт и генерацию. Это много истории: десятки тысяч слов истории могут поместиться. Стоимость растет вместе с ней, так как вся история отправляется каждый раз. Вот пример расчета для длинного сеанса.

Допустим, история выросла до 30 000 токенов, а ответ — 300 токенов. Вход: 30 000 x $0,15 / 1M = $0,0045. Выход: 300 x $0,50 / 1M = $0,00015. Один ответ стоит $0,00465. Сто ответов такого размера обойдутся в $0,465, то есть примерно 47 центов.

Короткая история дешевле и часто лучше. Модели меньше внимания уделяют середине очень длинных промптов, поэтому чистое резюме старых событий плюс последняя дюжина сообщений может читаться более последовательно, чем 30 000 необработанных токенов. Многие фронтенды имеют функцию резюме или «памяти». Используйте ее, когда чат превысит несколько тысяч токенов.

Цены: $0,15 за 1M ввода и $0,50 за 1M вывода. Неудачные или отклоненные запросы не оплачиваются, а баланс не сгорает. См. страницу цен для сумм пополнения, бонусов и способов оплаты, включая карту и криптовалюту.

Сохранение согласованности персонажа на протяжении недель

Долговременные персонажи теряют согласованность. Решение — в основном ведение заметок, и это стоит очень мало токенов, если делать это хорошо.

Сохраните фиксированный блок фактов, который не меняется: имя, личность, речевые привычки, отношения. Сохраните второй блок, который вы обновляете вручную время от времени: текущая ситуация, незавершённые сюжетные линии, данные обещания. Вставьте оба блока в системный промпт или поле памяти вашего клиента и держите каждый объёмом не более 500 токенов. Вместе это составляет не более 1 000 токенов, что стоит $0.00015 за ответ по ставке на ввод.

Затем оставьте в чате только недавний обмен. Когда сцена заканчивается, напишите два-три предложения резюме во второй блок и очистите старые сообщения. Ваши персонажи остаются четкими, ответы быстрее читаются, а стоимость за ответ остается близкой к десятой части цента, а не растет с каждым сеансом.

Если вы играете за несколько персонажей в одном чате, указывайте, кто говорит и когда. Строка вроде «Пишите только реплики Мары, если пользователь не запросит другого персонажа» предотвращает озвучивание всех сразу, что также держит ответы короткими и дешевыми.

Устранение ошибок 429 и странных ответов

Приложения для ролевых игр часто случайно превышают лимит запросов: две вкладки браузера, дважды нажатая кнопка «перегенерация», групповой чат, где несколько персонажей отвечают одновременно. API отвечает кодом HTTP 429 и одной из этих причин.

1. Код ошибки concurrency. У вас больше активных запросов, чем позволяет ваш ключ. Закройте лишние вкладки, дождитесь завершения потока или отключите параллельные ответы персонажей. Помните, что поток занимает слот до самого конца.
2. Код ошибки rate_limited. Вы отправили слишком много запросов за минуту. Замедлитесь: человек, набирающий текст, редко превышает 300 запросов в минуту, но автоматический цикл свайпов может достичь 60 на пробном ключе.
3. 429 с заголовком Retry-After: 5. Сервис временно перегружен. Подождите пять секунд и отправьте запрос снова.

Если ответы обрываются, проверьте настройку max_tokens в клиенте. Если персонаж говорит за вас, усильте правило в системном промпте и снизьте температуру. Если приложение сообщает, что модель не найдена, убедитесь, что поле модели содержит ровно uncensored, строчными буквами.

Где это подходит, а где — нет

Это работает как замена, когда ваш клиент позволяет выбрать свой эндпоинт, а вам нужна одна модель с фиксированной ценой за токен. Это не замена роутеру, если вам нравится переключаться между несколькими моделями во время чата. Вы получаете одну модель от независимого провайдера, а не официальное API любого вендора моделей.

Модель работает только с текстом. Она не генерирует арты персонажей, голос или видео, эмбеддинги также недоступны. Всё в вашем клиенте, что зависит от этих возможностей, потребует другого сервиса. Промпты не используются для обучения, а полный быстрый старт описан в документации.

Дополнительные руководства

• Альтернативы OpenRouter дешевле: Реальные затраты на токены
• Альтернатива OpenRouter для AI-моделей: Один против Многих
• API Perplexity: Как использовать LLM без цензуры