Skip to Content
IntegrationsImmersive Translate

Immersive Translate Setup

Immersive Translate  is a popular browser translation extension supporting bilingual side-by-side display, capable of translating web pages, PDFs, subtitles, and input fields across Chrome, Firefox, and Safari.

By configuring OfoxAI as your translation service, you can use GPT, Claude, Gemini, DeepSeek, and 100+ models with a single API Key.

Prerequisites

Supported Protocols

Immersive Translate supports three protocols with OfoxAI:

ProtocolSetup MethodCustom API EndpointSupported Models
OpenAI ChatCustom servicehttps://api.ofox.ai/v1/chat/completionsAll models
OpenAI ResponseCustom servicehttps://api.ofox.ai/v1/responsesAll models
ClaudeBuilt-in Claude providerhttps://api.ofox.ai/anthropicClaude series
Gemini (via OpenAI Chat)Custom servicehttps://api.ofox.ai/v1/chat/completionsGemini series

The built-in Gemini provider in Immersive Translate uses x-goog-api-key authentication, which is incompatible with OfoxAI’s Authorization: Bearer method. To use Gemini models, use the OpenAI Chat custom service and enter the Gemini model name in the custom model field (e.g. google/gemini-3.1-flash-lite-preview, google/gemini-3.1-pro-preview, etc.).

Setup Steps

Step 1: Open Translation Service Settings

Click the Immersive Translate icon in your browser toolbar, go to Settings, then click the Translation Service tab at the top.

Open translation service settings

Step 2: Find the Custom Service Entry

Scroll down to the Other/Custom section on the Translation Service page.

Translation service list

Click the Add Custom Translation Service button in the top right.

Add custom translation service

Step 3: Fill in the Configuration

Fill in the details based on your chosen protocol:

OpenAI Chat (supports all models including Gemini)

FieldValue
Service Nameofox (or any name)
Custom API Endpointhttps://api.ofox.ai/v1/chat/completions
API KeyYour OfoxAI API Key
ModelCheck “Enter custom model name”, e.g. openai/gpt-4.1

OpenAI Response

FieldValue
Service Nameofox-response (or any name)
Custom API Endpointhttps://api.ofox.ai/v1/responses
API KeyYour OfoxAI API Key
ModelCheck “Enter custom model name”, e.g. openai/gpt-4.1

Claude (Anthropic native protocol)

Use the built-in Claude provider — no need to add a custom service:

FieldValue
API KeyYour OfoxAI API Key
Custom API Endpointhttps://api.ofox.ai/anthropic
ModelCheck “Enter custom model name”, fill in claude-sonnet-4.6

Click Test Service, and once it passes click Save.

Fill in configuration

Step 4: Set as Default and Start Translating

In the translation service list, toggle the switch next to your configured service to set it as current default. Then open any webpage and press Alt + A (Mac: Option + A) to translate.

Translation Result

After setup, pages display original and translated text side by side.

Translation result

Available Model Examples

Full list at Models :

ProviderModelCustom Model Name
OpenAIGPT-4.1openai/gpt-4.1
OpenAIGPT-4.1 Miniopenai/gpt-4.1-mini
AnthropicClaude Sonnet 4.6anthropic/claude-sonnet-4.6 (OpenAI Chat) or claude-sonnet-4.6 (Claude)
AnthropicClaude Haiku 4.5anthropic/claude-haiku-4.5 (OpenAI Chat) or claude-haiku-4.5 (Claude)
GoogleGemini 3.1 Flash Litegoogle/gemini-3.1-flash-lite-preview
DeepSeekDeepSeek V3.2deepseek/deepseek-v3.2

Troubleshooting

Q: Error String contains non ISO-8859-1 code point during test

Your API Key contains non-ASCII characters (e.g. full-width spaces). Re-copy the API Key from the OfoxAI Console  and make sure there are no extra characters.

Q: Can the built-in Gemini provider connect to OfoxAI?

No. The built-in Gemini provider uses x-goog-api-key authentication, incompatible with OfoxAI’s Authorization: Bearer. Use the OpenAI Chat custom service and enter the Gemini model name in the custom model field (e.g. google/gemini-3.1-flash-lite-preview, google/gemini-3.1-pro-preview, etc.).

Q: How do I switch between translation services?

On the Translation Service page, toggle the switch next to the service you want to use as the current default.

Last updated on