Подключение Luna Translator

Сложность 🧩 Средняя　|　Формат интерфейса Совместимый с OpenAI　|　base_url https://byesu.com/v1

Данные подключения

Адрес APIhttps://byesu.com/v1

Ключ APIsk-xxxxxxxxСоздать в консоли →

Модельgpt-5.5

Формат API OpenAI совместимо · имена моделей — по консоли

LunaTranslator — это открытый переводчик для GalGame и визуальных новелл. Он поддерживает извлечение текста через HOOK, распознавание OCR и подключение больших языковых моделей для AI-перевода. Подключив его к Byesu API, вы сможете в реальном времени переводить игровой текст с помощью моделей gpt-5.5, claude-opus-4-8 и других.

Перед началом

Сначала перейдите в Панель управления → Токены и создайте API-токен (в формате sk-xxxx). При создании обязательно выберите правильную группу: группа определяет, какие модели вам доступны и каким образом происходит тарификация. Подробнее см. Выбор группы.

Шаг 1. Загрузка и установка Luna Translator

Перейдите в официальную документацию LunaTranslator, скачайте последнюю версию, распакуйте архив и запустите главную программу (для Windows это portable-версия без установки).

Шаг 2. Настройка интерфейса больших языковых моделей

LunaTranslator предлагает два способа: «импорт в один клик» и «ручная настройка». Рекомендуем сначала попробовать первый способ.

Способ 1 (самый быстрый): импорт из панели управления в один клик

1. В панели управления Byesu откройте Системные настройки → Настройки чата и добавьте следующую ссылку перехода в чат:

Ссылка настроек чата

{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }

2. Перейдите в Панель управления → Управление токенами (Token), найдите свой токен, нажмите на стрелку выпадающего списка справа от «Чат» и выберите LunaTranslator. Браузер автоматически запустит клиент и запишет конфигурацию.
3. В LunaTranslator откройте Настройки → Настройки перевода → Большие модели и найдите только что автоматически добавленную конфигурацию интерфейса.
4. Нажмите кнопку «Обновить» рядом с выпадающим списком моделей, чтобы загрузить список доступных моделей из Byesu, выберите одну (например, gpt-5.5) и сохраните.
5. Включите переключатель активации слева от этой конфигурации интерфейса.

Способ 2: ручная настройка

1. В Панели управления → Управление токенами скопируйте свой API Key (sk-xxxx).
2. В LunaTranslator откройте Настройки → Настройки перевода → Большие модели и нажмите «Добавить».
3. Скопируйте шаблон «Универсальный интерфейс больших моделей».
4. Заполните поля нового интерфейса следующими значениями:

Поле	Значение
Адрес API-интерфейса / base_url	https://byesu.com/v1
API Key	sk-xxxx (ваш токен)
Модель model	gpt-5.5 (или выберите после обновления на следующем шаге)

5. Нажмите «Обновить» рядом с полем модели и выберите нужную модель из выпадающего списка.

Не забудьте про /v1 в адресе

LunaTranslator использует совместимый с OpenAI интерфейс, поэтому base_url обязательно должен быть https://byesu.com/v1 (с /v1 в конце). Если указать https://byesu.com, интерфейс не будет распознан.

Шаг 3. Активация и проверка

1. Включите переключатель активации слева от этой конфигурации интерфейса.
2. Вернитесь на главный экран и в движке перевода отметьте этот интерфейс больших моделей как источник перевода.
3. Захватите фрагмент игрового текста с помощью HOOK или OCR и убедитесь, что перевод корректно возвращается — это означает, что подключение прошло успешно.

Рекомендуемые модели:

• Приоритет скорости и выгодная цена: gpt-5.5
• Более тонкое качество перевода: claude-opus-4-8
• Длинные тексты / многоязычность: gemini-3.1-pro-high

Застряли?

• Ошибка 401 / сбой аутентификации: API Key введён неверно или содержит лишние пробелы — заново скопируйте sk-xxxx из управления токенами. См. Частые ошибки #auth.
• Сообщение об отсутствии доступного канала / модель не существует: в группе текущего токена нет этой модели — выберите другую модель или измените группу. См. Выбор группы и Частые ошибки #no-channel.
• Недостаточно квоты / нулевой баланс: квота токена исчерпана — пополните баланс или проверьте лимит квоты токена. См. Частые ошибки #balance.
• Список моделей пуст после обновления: убедитесь, что base_url заканчивается на /v1 и токен действителен.

Дополнительные способы устранения неполадок см. в разделе Частые ошибки.