Suanlimao
← Back to all tutorials

Connect your tools

Immersive Translate

Browser translation extension: point its OpenAI service at our address.

About 5 minFor:People who translate web pages, PDFs and subtitles with Immersive Translate

Before you start

  • The Immersive Translate extension is installed
  • A key just for translation (create a separate one and give it a budget)

Step 1 · STEP 0x01

Pick the OpenAI service and enter the key

Immersive Translate → Settings → Translation services
1

Translation service

OpenAI
2

api_key

<YOUR_API_KEY>
3

More settings (expand)

Expanded
Diagram only — the real screen in your version may differ
  • Open the extension settings, choose OpenAI as the translation service and put the key in api_key.
  • Expand More settings — the custom model and custom URL live there.
Immersive Translate's own “connect other AI models” page uses exactly this route: the OpenAI service plus a custom URL. Field wording changes between versions, so follow your current screen.

Create a key →

Step 2 · STEP 0x02

Enter the custom URL and model

OpenAI → More settings
1

Custom URL

https://api.suanlimao.shop/v1/chat/completions
2

Custom model

<MODEL_NAME>
3
Test service
Diagram only — the real screen in your version may differ
  • The custom URL is the full path https://api.suanlimao.shop/v1/chat/completions — every example on the official page ends that way.
  • Type the model by hand; a cheap, fast model from the plaza suits translation best.
  • Click the test button, then save.
Don't guess the model name: open the model plaza, click “Copy model id” on a model card and paste it. A wrong model name is the most common error.

Open the model plaza →

Step 3 · STEP 0x03

Keep translation costs in check

Console → API keys → Edit
1

Budget (USD)

e.g. a monthly cap for the translation key
2

Max requests per second (in the extension)

The official docs suggest lowering it to 5
3
Save
Diagram — the wording matches the real page, the layout may differ slightly
Page and subtitle translation keep sending requests in the background; auto-translating whole pages can burn a lot in a day. Give this key a monthly budget.

✓ How to tell it worked

  • Translate a foreign-language page and see the result; the Usage page shows the requests.

FAQ

The test fails.

Make sure the custom URL is the full path https://api.suanlimao.shop/v1/chat/completions and the model name is right.

I get 429.

Per the official docs, 429 means too many requests per second. Lower “max requests per second” in the extension (5 is suggested) or pick a faster model.

Related tutorials

Still stuck?

Read the troubleshooting tutorials first. If that does not help, open a ticket with the request_id, time, model and the exact error (never paste your key).