# Immersive Translate

В Immersive Translate можно добавлять пользовательские AI-сервисы перевода. Введите адрес, ключ и модель, чтобы переводить веб-страницы и PDF моделями NezhaGate.

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

Проверено на версии Immersive Translate 1.33

## Добавьте сервис перевода

1. Откройте в расширении **Settings** → **Translation Services**, прокрутите до конца и нажмите **Add Custom Translation Service**.

2. Выберите **Custom AI** (не Custom API — это другой протокол).

3. Заполните поля, как показано ниже, и сохраните.

| Поле | Что вписать |
| --- | --- |
| **Custom API interface address** | `https://nezhagate.com/v1/chat/completions` |
| **APIKEY** | Ваш API-ключ NezhaGate |
| **Model** | Нажмите **Set up more models**, впишите ID моделей в **Custom Model List** (через запятую), затем выберите нужную. |
| **Max requests per second** | Для начала подойдёт 3–5 (по умолчанию 5). При переводе страницы одновременно уходит много запросов, и слишком высокое значение может привести к лимиту частоты запросов. |

## Какую модель выбрать

Перевод страницы — это множество коротких запросов, поэтому лучше всего подходит модель, которая отвечает быстро и без долгих размышлений; модель с размышлениями думает перед каждым абзацем, что медленнее и расходует больше выходных токенов. Например:

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

## Claude (необязательно)

Можно также использовать встроенный в расширение сервис **Claude** со своим ключом, указав в адресе API `https://nezhagate.com/anthropic/v1/messages`.

## Проверка

Нажмите **Verify service**; когда появится **Successful**, попробуйте перевести любую страницу.

## Частые ошибки

**429 или перевод, который обрывается на середине**

Уменьшите **Max requests per second**, например до 3.

**401 / 404**

401 означает, что ключ неверный; 404 — что адрес неверный. Должно быть `https://nezhagate.com/v1/chat/completions`.

**Проверка сервиса раз за разом не проходит**

Убедитесь, что выбран тип **Custom AI**, а не Custom API, и что ID модели добавлен в список пользовательских моделей и выбран.

**Версия в виде пользовательского скрипта не отправляет запросы**

В заголовке скрипта нужно объявить домен NezhaGate директивой `// @connect`.