Immersive Translate custom API setup guide
Configure the Immersive Translate browser extension to use the qionggeme API for cost-controlled translation with currently available GPT or Claude models.
Quick configuration
- Translation service
OpenAI- Custom API URL
https://qionggeme.com- Usually enter the root URL first. If the extension rejects it, try https://qionggeme.com/v1.
- API Key
sk-your API key- Recommended model
gpt-5.4-mini or claude-haiku-4-5-20251001- Maximum request rate
About 5 requests/second
Why use a gateway for translation?
- Direct OpenAI registration may be inconvenient in some regions, while a gateway can be funded and used through one account.
- qionggeme provides transparent pricing and access to multiple available Claude and GPT models.
- Translation usually works well with smaller models, keeping cost predictable.
Before you begin: install the Immersive Translate extension and create a qionggeme API key in the console.
Setup steps
Open Immersive Translate settings
Click the Immersive Translate icon in the browser toolbar, choose Options or Settings, and open Translation Services in the left navigation.
Select the OpenAI translation service
Find and expand OpenAI. The extension supports an OpenAI-compatible endpoint, which allows qionggeme to connect directly.
Enter the custom API URL and key
Expand the advanced settings, find Custom API URL, and enter:
Custom API URL: https://qionggeme.com API Key: sk-your API key
Choose a translation model
Enter a currently available lightweight model ID:
gpt-5.4-mini— cost-effective for frequent translation.claude-haiku-4-5-20251001— a lightweight Claude model with natural Chinese output.
See the model pricing page for current options. Translation usually does not need a flagship reasoning model.
Limit the request rate and run a test
Set Maximum Request Rate to about 5 requests per second to reduce 429 errors. Click Test, and after it succeeds, use the extension on a webpage.
Configuration example
# Immersive Translate core settings Translation service: OpenAI Custom API URL: https://qionggeme.com API Key: sk-your API key Model: gpt-5.4-mini or claude-haiku-4-5-20251001 Maximum request rate: 5 requests/second
Troubleshooting
The extension returns 429 Too Many Requests
Reduce Maximum Request Rate to about 5 requests per second or lower. Long documents, ebooks, PDFs, and subtitle batches can generate many concurrent requests.
The custom API URL returns an endpoint error
Start with https://qionggeme.com. If the installed extension version expects an OpenAI Base URL, try https://qionggeme.com/v1. Never use https://qionggeme.com/docs.
Translation is too expensive
Use a lightweight model such as gpt-5.4-mini or claude-haiku-4-5-20251001, lower concurrency, and avoid flagship reasoning models for routine translation.
The configured model is not found
Copy the exact current ID from the model pricing page or console. Model IDs are case- and punctuation-sensitive.
Ready to get started?
Create a qionggeme account, generate an API key, and access every currently available model.
Create an accountFrequently asked questions
How do I fix 429 Too Many Requests?
Lower the maximum request rate, for example to 5 requests per second. This is especially important for long documents, ebooks, PDFs, and subtitle batches.
Which model offers good translation quality at a lower cost?
Start with gpt-5.4-mini or claude-haiku-4-5-20251001. Flagship models cost more and often provide limited benefit for routine translation.
Does Immersive Translate support PDFs and video subtitles?
The extension supports webpages, PDFs, subtitles, EPUB files, and other scenarios depending on the installed version. One API configuration can generally be reused across those features.
Can several browsers share one API key?
Yes, but the combined request rate must remain within the account and token limits. Rotate the key immediately if it is exposed.