Home / Help / How to Use OpenRouter in Thaluna

Cloud translation

How to Use OpenRouter in Thaluna

OpenRouter lets Thaluna use cloud translation models when you want higher quality than local models alone. This guide covers setup and the most common failure points.

Video setup guide

Configure OpenRouter in Thaluna

Follow the complete setup from creating an API key to selecting a cloud model, choosing a target language, and testing the result with Game Lens.

Watch the OpenRouter guide

Where OpenRouter Is Configured

Thaluna OpenRouter and Ollama settings from an earlier build — Add your API key and choose a model in Ollama / Cloud settings. This earlier screenshot shows an old model label; the current default is Gemini 3.1 Flash Lite.

Thaluna translation model selection — Select the translation source and target language in the language/model selector.

Step 1: Create account and balance

Go to OpenRouter, create an account, and add a small balance. For testing, even a small amount is enough.

Step 2: Generate API key

Create a new API key in your OpenRouter dashboard and keep it private.

Step 3: Add key in Thaluna

Open Settings → Ollama/Cloud, paste the key, choose a model, and save.

Step 4: Enable OpenRouter in Languages

Open the translation model selector, switch to OpenRouter, choose the target language, and confirm with OK.

Which OpenRouter model should I choose?

Thaluna includes presets for Gemini 3.1 Flash Lite, GPT-6 Luna with reasoning disabled, GPT-4.1 nano, and GPT-4o mini. You can also enter a custom model ID. For model choices and pricing guidance, read the Translation Quality Guide.

The same key can also power TTS

Real-Time TTS can use Gemini 3.8 Flash Lite TTS, Gemini 3.8 Flash TTS, Gemini 3.1 Flash TTS Preview, Grok Voice TTS 1.0, or MAI Voice 2 Flash through OpenRouter. Select a model in Settings > TTS. Language coverage, voices, availability, and pricing vary by model and may change over time. TTS usage is billed separately by OpenRouter.

If cloud mode is not working

Regenerate the API key and paste it again carefully
Make sure the key saved in %localappdata%\Thaluna\secrets\openrouter_api_key.json matches your current key
Check that your OpenRouter account has balance available
Try a different model
Temporarily test another network or phone hotspot if VPN, proxy, firewall, or antivirus web protection may be interfering