# Immersive Translate

Immersive Translate permite añadir servicios de traducción con IA personalizados. Introduce la dirección, la clave y el modelo para traducir páginas web y PDF con los modelos de NezhaGate.

> https://nezhagate.com/es/docs/integrations/immersive-translate

Escrita con Immersive Translate 1.33

## Añade el servicio de traducción

1. Abre **Settings** → **Translation Services** de la extensión, baja hasta el final y haz clic en **Add Custom Translation Service**.

2. Elige **Custom AI** (no Custom API, que usa otro protocolo).

3. Rellena los campos como se indica abajo y guarda.

| Campo | Qué poner |
| --- | --- |
| **Dirección de la interfaz de la API personalizada** | `https://nezhagate.com/v1/chat/completions` |
| **APIKEY** | Tu clave de API de NezhaGate |
| **Modelo** | Haz clic en **Set up more models**, escribe los ID de los modelos en **Custom Model List** (separados por comas) y selecciona uno. |
| **Máximo de peticiones por segundo** | 3–5 es un buen punto de partida (el valor por defecto es 5). Traducir una página entera envía muchas peticiones a la vez, y un valor demasiado alto puede activar los límites de velocidad. |

## Qué modelo usar

Traducir una página son muchas peticiones cortas, así que va mejor un modelo que responda rápido y sin razonar mucho; un modelo de razonamiento piensa antes de cada párrafo, lo que es más lento y gasta más tokens de salida. Por ejemplo:

`gemini-3.6-flash-low` · `claude-sonnet-4-6`

## Claude (opcional)

También puedes usar el servicio **Claude** integrado en la extensión con tu propia clave, poniendo la dirección de la API en `https://nezhagate.com/anthropic/v1/messages`.

## Prueba

Haz clic en **Verify service**; cuando muestre **Successful**, traduce cualquier página para probarlo.

## Errores habituales

**429, or a translation that fails halfway**

Baja **Max requests per second**, por ejemplo a 3.

**401 / 404**

401 significa que la clave está mal; 404 significa que la dirección está mal. Debería ser `https://nezhagate.com/v1/chat/completions`.

**The service test keeps failing**

Asegúrate de que el tipo sea **Custom AI**, no Custom API, y de que el ID del modelo esté en la lista de modelos personalizada y seleccionado.

**The userscript version cannot send requests**

La cabecera del script debe declarar el dominio de NezhaGate con `// @connect`.