LunaTranslator
Translate visual novels in real time with RuToken models through LunaTranslator's large-model interface.
LunaTranslator is a free, open-source translator for visual novels (galgames). It extracts text with HOOK (including emulators for NS / PSP / PSV / PS2 games) or OCR, can embed translations directly into some games, and supports many translation engines including large language models, plus TTS and Japanese learning tools. Docs: docs.lunatranslator.org.
Prerequisites
- An API key: open the console, go to API Keys and create a dedicated key (for example, named
LunaTranslator). - LunaTranslator installed — see Download & Launch & Update.
Configuration
Option A: one-click setup
- On the API Keys page, open the actions menu of the key and choose Chat → LunaTranslator (available when your administrator has enabled it). LunaTranslator opens and creates a large-model interface with the address and key filled in.
- In LunaTranslator, go to Settings → Translation Settings → Large Models and click Edit on the new interface.
- Click the refresh button next to the model drop-down to load the model list, select a model and click OK.
- Make sure the switch next to the interface is turned on.
Option B: manual setup
-
In LunaTranslator, open Settings → Translation Settings → Large Models.
-
Copy the General LLM interface template to create a new interface, and fill in:
Field Value API address https://rutoken.aiAPI Key sk-xxxxmodel a model ID from the Model Square, e.g. gpt-4o-mini -
Use the refresh button next to the model drop-down to load the list, select a model and click OK.
-
Turn on the switch next to the new interface.
Verify
Start a game (or paste some text into LunaTranslator) and check that the new interface returns a translation. The requests appear in the console under Usage Logs.
Troubleshooting
| Symptom | Fix |
|---|---|
401 / invalid API key |
Paste the full key again; check that it is enabled, not expired and has quota left. |
404 / not found |
Enter the root address https://rutoken.ai; if your LunaTranslator version does not complete the path itself, try https://rutoken.ai/v1. |
| Model not found | Select a model loaded with the refresh button, or type an exact ID from the Model Square. |
| No translation appears | Check that the interface switch is on and that other translators are not overriding it. |
See also: LunaTranslator — Large model translation interface.