Set up Immersive Translate
Bilingual web and PDF translation extension, fast and cheap with CherryChat models
- API format: OpenAI Chat Completions
- Base URL format: Full path to /v1/chat/completions (https://gpt.cherrychat.org/v1/chat/completions)
- Recommended model: deepseek-v4-flash, gemini-3.1-flash-lite-preview
- Platforms: Browser extension
Steps
Open the translation service settings
Click the Immersive Translate icon in the browser toolbar → Settings, then choose Translation Services on the left.
Open the OpenAI service settings
Find "OpenAI" in the service list and open its settings (the button name varies by version). Choose to use your own API key rather than the membership service.
Fill in the key, model and endpoint
In the model dropdown choose the custom model option and type the name. The endpoint field is under "More settings"; enter the full path ending in /v1/chat/completions.
- API key: sk-your-key
- Custom model: deepseek-v4-flash
- Custom API endpoint: https://gpt.cherrychat.org/v1/chat/completions (Must be the full URL; the bare domain returns 404)
Lower the request rate and save
Set "max requests per second" to about 5 (the official recommendation), keep "max paragraphs per request" at the default, and save.
Make it the default and test
Back in Basic Settings, set the translation service to OpenAI. Open any English page and click the floating button or press Alt+A (Option+A on Mac); bilingual text means it works.
Common pitfalls
- The endpoint must be the full URL ending in /v1/chat/completions (https://gpt.cherrychat.org/v1/chat/completions); the domain or /v1 alone returns 404.
- Choose the custom model option and type the name exactly as on the Models page (all lowercase).
- Full-page translation sends many requests: use a cheap, fast model (e.g. deepseek-v4-flash, gemini-3.1-flash-lite-preview) and about 5 requests per second, or you will hit 429 and burn credits.
- The official docs do not say whether the free plan allows your own API key (checked 2026-11-02). If the settings page asks for Pro, follow what the extension shows.
- Separate multiple keys with English commas; they are used in turn.
Error → cause → fix
| What you see | Why | What to do |
|---|---|---|
| Translation fails with 401 | The key is wrong, has spaces, or was disabled | Copy the key again from My Keys and paste it |
| Translation fails with 404 | The custom endpoint is not the full URL | Change it to https://gpt.cherrychat.org/v1/chat/completions |
| Model not found | The custom model option is not selected, or the name is wrong | Choose the custom model option and enter deepseek-v4-flash |
| Some paragraphs fail with 429 | Full-page translation is too parallel and exceeds the default 120 requests per minute per key or 8 at a time per account | Lower "max requests per second" to 2–5 and retry the failed paragraphs |
| HTTP 402 or "insufficient balance" (billing_error in Claude format) | Your credits cannot cover this call. API calls are paid from credits only; memberships and unlimited plans do not apply | Top up any amount in the CherryChat Store, then retry after a few seconds |
Guide checked 2026-11-02. The tool's screens may change; the official docs win if they differ.
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · Support WeChat: JsnonoChat · Content is AI-generated — please verify before relying on it
