# Immersive Translate Integration Guide

Immersive Translate is a popular bilingual webpage translation browser extension that supports calling custom AI models for translation. This guide explains how to use it to call models through the UModelverse platform.

## **System Requirements**

-   A mainstream browser such as Chrome, Edge, or Firefox, or its mobile app.
    
-   A network connection.
    

## **1. Install Immersive Translate**

Go to the [Immersive Translate official website](https://immersivetranslate.com/) or search for "Immersive Translate" in your browser's extension store to install it.

## **2. Obtain an API Key**

Visit the [UModelverse Console](https://console.ucloud.cn/modelverse/api) to get your API key. For available models, see the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform.

## **3. Configure the UModelverse Model**

UModelverse uses the OpenAI-compatible protocol, so use Immersive Translate's "OpenAI" translation service to connect.

1.  Click the extension icon and go to **Settings** → **Translation Services**.

    ![Immersive Translate translation service list](https://cdnv2-cache.udelivrs.com/2026/06/9b449970b82dbfe8706d3c431ddf10f6_1781261163439.png)

2.  Click **Add Custom Translation Service** in the top right corner, then select **OpenAI** in the pop-up.

    ![Add custom translation service and select OpenAI](https://cdnv2-cache.udelivrs.com/2026/06/69133be38e2040121b707f26deac8f7b_1781261163443.png)

3.  Fill in the fields according to the table below:

| Field | Value |
| --- | --- |
| APIKEY | Your UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| Custom Translation Service Name | Any name you like, e.g. `UModelverse` |
| Model | One of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform, e.g. `qwen3.7-max`; check **Enter the name of the custom model** |
| Custom API interface address | `https://api-us-ca.umodelverse.ai/v1/chat/completions` |

![Fill in APIKEY, service name and model](https://cdnv2-cache.udelivrs.com/2026/06/86482dddda44e71464f18674c66a3694_1781261163452.png)

![Fill in the custom API interface address](https://cdnv2-cache.udelivrs.com/2026/06/cb1991323c3772a3ec53854bb4d65598_1781261163455.png)

4.  Click "Test Service" to confirm connectivity, then save and set this service as the default translation service.
    

> Note: In some versions, the API endpoint only needs to be filled in up to `https://api-us-ca.umodelverse.ai/v1` — the extension will automatically append the path. If the test fails, try switching between the two formats.

## **Frequently Asked Questions**

### Service test fails or translation returns an error?

Please check each of the following:

1.  The APIKEY is from the UModelverse platform, copied in full with no spaces.
    
2.  The API endpoint is `https://api-us-ca.umodelverse.ai/v1/chat/completions` (or `https://api-us-ca.umodelverse.ai/v1`).
    
3.  The model is one of the [supported models](https://api-us-ca.umodelverse.ai/v1/models) on the UModelverse platform and has been entered correctly.
    
4.  If you receive a message about too many requests, reduce the concurrency settings such as "Maximum requests per second" in the settings.