Обновление (8 октября 2026 г.): Отдельного API у Immersive Translate по-прежнему нет: это расширение и приложения для перевода, которые по данным официального сайта подключают более 20 движков, включая ChatGPT, DeepL, DeepSeek и Gemini. Свой ключ OpenAI вводится в настройках сервиса OpenAI, а адрес стороннего API задаётся в разделе «More Settings» (инструкция Immersive Translate). Модели в примерах ниже (GPT-4o-mini, GPT-4, Claude 3) — прошлые поколения, а цены за токены из старой версии статьи убраны; какую модель OpenAI выбрать сейчас, разобрано в статье «Какую модель OpenAI выбрать для API».
Ищете "Immersive Translate API" и не можете найти документацию? Это не случайность. Immersive Translate — это не провайдер API, а расширение для браузера и приложения, которые подключаются к существующим сервисам перевода. По данным официального сайта, им пользуются более 30 млн человек. Ниже — как подключить к нему свой API-ключ и что делать, если прямой доступ к API из России затруднён.
Что такое Immersive Translate на самом деле
Immersive Translate (沉浸式翻译) — это браузерное расширение, разработанное для создания настоящего двуязычного интернета. В отличие от традиционных переводчиков, которые заменяют оригинальный текст, Immersive Translate показывает перевод рядом с оригиналом, сохраняя контекст и позволяя изучать язык в процессе чтения.
Ключевые возможности
По официальному сайту на 8 октября 2026 года.
Поддержка контента:
- Веб-страницы с двуязычным отображением
- Документы: PDF (в том числе сканы с OCR), ePub, DOCX, HTML, TXT, Markdown и файлы субтитров
- Субтитры более чем на 100 видеоплатформах, включая YouTube, Netflix и Prime Video
- Онлайн-встречи в Zoom, Google Meet и Microsoft Teams
- Изображения и комиксы
Поддерживаемые платформы:
- Расширения для Chrome, Edge, Firefox и Safari, а также ZIP-архив и Userscript
- Приложения для iOS и Android
Что такое «Nano Immersive Translate»
В Chrome Web Store есть отдельное расширение «Nano Immersive Translate». Судя по его странице, это продукт другого разработчика (сайт поддержки — gemininano.yinming.org), а не официальное расширение Immersive Translate. Оно работает на встроенной в Chrome локальной модели Gemini Nano, поэтому не требует API-ключа и регистрации.
Почему Immersive Translate, а не встроенный переводчик браузера
В то время как Google Chrome предлагает базовый перевод страниц, Immersive Translate выводит эту функцию на профессиональный уровень:
- Двуязычное отображение — оригинал и перевод видны одновременно
- Выбор движка перевода — более 20 движков, включая ChatGPT, DeepL, DeepSeek и Gemini
- Контекстный перевод — учитывает окружающий текст для точности
- Настройка под домен — разные движки для разных сайтов
- Перевод защищенного контента — работает там, где обычные переводчики бессильны
Архитектура: как расширение работает с API

Поток данных при переводе
- Захват контента — расширение анализирует DOM страницы
- Сегментация — текст разбивается на оптимальные блоки
- API запрос — отправка на выбранный сервис перевода
- Обработка ответа — получение и форматирование перевода
- Инъекция в страницу — вставка перевода с сохранением стилей
Поддерживаемые API и их особенности
OpenAI:
- Хорошее качество для технических текстов
- Понимание контекста и терминологии
- Нужен ключ API OpenAI, а не подписка ChatGPT
- Актуальные модели и цены: список моделей и страница цен
DeepL:
- Сильная сторона — европейские языки
- Естественность перевода
- Цены — на сайте DeepL
Google Translate:
- Максимальная скорость
- Поддержка редких языков
- Базовое качество для сложных текстов
Claude (Anthropic), Gemini, DeepSeek:
- Подходят для литературных текстов и сохранения стиля
- Подключаются своим ключом соответствующего провайдера
- Цены — на страницах провайдеров
Локальные модели:
- LibreTranslate для приватности
- Работа без интернета
- Настройка под специфические задачи
- Бесплатно после настройки
Проблема доступа для российских пользователей
С марта 2022 года российские пользователи столкнулись с каскадом ограничений:
Технические блокировки
- IP-фильтрация — OpenAI, Anthropic, DeepL блокируют российские адреса
- Платежные ограничения — невозможность оплаты российскими картами
- Аккаунтные проверки — требование зарубежного номера телефона
- Cloudflare проверки — дополнительная защита от российского трафика
Юридические риски
Использование VPN для обхода создает проблемы:
- Нарушение условий использования сервисов
- Риск блокировки корпоративных аккаунтов
- Неопределенность правового статуса
- Сложности с налоговым учетом
Экономические последствия
Даже при наличии доступа, российские компании сталкиваются с:
- Завышенными комиссиями при конвертации валюты
- Необходимостью содержать зарубежные юрлица
- Дополнительными расходами на инфраструктуру обхода
Вариант с API-шлюзом laozhang.ai
laozhang.ai — API-шлюз, через который модели разных провайдеров доступны по одному ключу в формате OpenAI API.
Как это работает технически
- Единый endpoint — все запросы идут через api.laozhang.ai
- Прозрачная проксификация — сохранение оригинального API формата
- Интеллектуальная маршрутизация — выбор оптимального сервера
- Кэширование — экономия на повторных запросах
- Мониторинг доступности — автоматическое переключение при сбоях
Экономическая модель

Стоимость перевода зависит от выбранной модели и объёма текста. Прежде чем выбирать между прямым API провайдера и шлюзом, сравните актуальные цены на сайтах обоих.
Что ещё учитывать:
- Способ оплаты, доступный вам
- Нужны ли вам VPN и зарубежная карта для прямого доступа
- Расходы на конвертацию валюты
Пошаговая настройка: от регистрации до первого перевода
Шаг 1: Регистрация на laozhang.ai
# Переход на страницу регистрации
https://api.laozhang.ai/register/
Процесс регистрации:
- Введите email или используйте TG
- Подтвердите почту (письмо приходит за 1-2 минуты)
- Заполните профиль (опционально)
- Получите API ключ в личном кабинете
Шаг 2: Установка Immersive Translate
Для Chrome/Edge:
// Прямая ссылка на Chrome Web Store
https://chrome.google.com/webstore/detail/immersive-translate/bpoadfkcbjbfhfodiogcnhhhpibjhbnh
// Альтернативная установка через ZIP (для РФ)
https://github.com/immersive-translate/immersive-translate/releasesДля Firefox:
// Firefox Add-ons
https://addons.mozilla.org/firefox/addon/immersive-translate/
// Проверка после установки
about:debugging#/runtime/this-firefoxШаг 3: Настройка API в расширении
Базовая конфигурация для OpenAI:
- Откройте настройки расширения (иконка в панели браузера → ⚙️)
- Перейдите в "Сервисы перевода" → "OpenAI"
- Введите API-ключ; адрес стороннего API указывается в разделе «More Settings» (в официальном примере это полный адрес, заканчивающийся на
/chat/completions). Несколько ключей можно ввести через запятую для балансировки нагрузки:
// Конфигурация для laozhang.ai
{
"apiKey": "sk-xxxxxxxxxxxxxx", // Ваш ключ от laozhang.ai
"apiUrl": "https://api.laozhang.ai/v1/chat/completions",
"model": "gpt-4o-mini", // пример; выберите актуальную недорогую модель
"temperature": 0.3, // Низкая для точности перевода
"maxTokens": 2000, // Достаточно для большинства текстов
"systemPrompt": "You are a professional translator. Translate naturally while preserving the original meaning and style."
}Для DeepL используйте собственный ключ DeepL API в настройках сервиса DeepL.
Шаг 4: Тонкая настройка под ваши задачи
Логика выбора движка под тип сайта: для технической документации — модель, которая не трогает код и термины, для статей и блогов — DeepL или Google, для научных текстов — более сильная модель с промптом про формулы и ссылки. Сами правила и горячие клавиши настраиваются в интерфейсе расширения; их набор зависит от версии, поэтому сверяйтесь с настройками своей установки.
Продвинутые сценарии использования
Если нужен перевод в собственном приложении или на сайте, расширение для этого не подходит — нужен прямой вызов API модели. Примеры ниже обращаются к OpenAI-совместимому API напрямую.
Интеграция с CMS для мультиязычных сайтов
// WordPress плагин для автоперевода
class ImmersiveTranslateWP {
constructor(apiKey) {
this.apiEndpoint = 'https://api.laozhang.ai/v1/chat/completions';
this.apiKey = apiKey;
}
async translatePost(postContent, targetLang) {
const prompt = `Translate the following WordPress post to ${targetLang}.
Preserve HTML tags and shortcodes: ${postContent}`;
const response = await fetch(this.apiEndpoint, {
method: 'POST',
headers: {
'Authorization': `Bearer ${this.apiKey}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'gpt-4o-mini',
messages: [{
role: 'system',
content: 'You are a professional translator for web content.'
}, {
role: 'user',
content: prompt
}],
temperature: 0.3
})
});
const data = await response.json();
return data.choices[0].message.content;
}
}Создание переводческого API для мобильных приложений
// Android приложение: перевод через OpenAI-совместимый API
class TranslationService(private val apiKey: String) {
private val client = OkHttpClient()
private val baseUrl = "https://api.laozhang.ai/v1"
suspend fun translateText(
text: String,
sourceLang: String = "auto",
targetLang: String = "ru"
): TranslationResult {
val requestBody = JSONObject().apply {
put("model", "gpt-4o-mini")
put("messages", JSONArray().apply {
put(JSONObject().apply {
put("role", "system")
put("content", "Translate text preserving tone and style")
})
put(JSONObject().apply {
put("role", "user")
put("content", "Translate from $sourceLang to $targetLang: $text")
})
})
}
val request = Request.Builder()
.url("$baseUrl/chat/completions")
.addHeader("Authorization", "Bearer $apiKey")
.post(requestBody.toString().toRequestBody())
.build()
return withContext(Dispatchers.IO) {
val response = client.newCall(request).execute()
parseTranslationResponse(response)
}
}
}Решение типичных проблем
Проблема 1: Медленная скорость перевода
Симптомы: Страницы переводятся по 30-60 секунд
Решения:
- Переключитесь на более быстрый сервис (Google Translate)
- Уменьшите размер блоков перевода в настройках
- Используйте кэширование для повторяющегося контента
- При частых ошибках 429 снизьте максимальное число запросов в секунду в настройках сервиса: Immersive Translate для OpenAI советует около 5 запросов в секунду
- Если используете API-шлюз, проверьте задержку до его сервера
Проблема 2: Неточный перевод терминологии
Решение через кастомные промпты:
// Настройка глоссария для домена
const customPrompts = {
"medical": `You are translating medical texts.
Use this glossary: ${medicalGlossary}.
Preserve Latin terms in parentheses.`,
"legal": `Legal translation with Russian law terms.
Keep original terms in brackets.
Use formal register.`,
"technical": `Technical documentation translation.
Preserve code, commands, and API names.
Translate comments but not code.`
};Проблема 3: Лимиты API и rate limiting
Стратегии оптимизации:
import asyncio
from functools import wraps
import time
class RateLimiter:
def __init__(self, calls_per_second=0.5):
self.calls_per_second = calls_per_second
self.last_call = 0
async def __aenter__(self):
elapsed = time.time() - self.last_call
sleep_time = (1.0 / self.calls_per_second) - elapsed
if sleep_time > 0:
await asyncio.sleep(sleep_time)
self.last_call = time.time()
async def __aexit__(self, *args):
pass
# Использование
limiter = RateLimiter(calls_per_second=0.2) # Безопасный лимит
async def translate_with_limit(text):
async with limiter:
return await api.translate(text)Проблема 4: Блокировка аккаунта
Превентивные меры:
- Не превышайте 80% от заявленных лимитов
- Распределяйте нагрузку по времени
- Используйте несколько API ключей для балансировки
- Мониторьте использование через дашборд
Оптимизация затрат: практические советы
Выбор оптимальной модели
Матрица принятия решений:
| Тип контента | Рекомендуемый вариант |
|---|---|
| Новости, блоги | Google Translate или DeepL |
| Техническая документация | недорогая модель OpenAI или другого провайдера |
| Юридические тексты | старшая модель с глоссарием в промпте |
| Маркетинг, креатив | модель, сильная в стиле (например, Claude) |
| Простые UI элементы | локальные модели |
Цены моделей меняются часто, поэтому сравнивайте их по актуальным страницам провайдеров.
Гибридная стратегия
class HybridTranslator {
constructor(configs) {
this.translators = configs;
this.stats = new UsageStats();
}
async smartTranslate(text, context) {
// Анализ сложности текста
const complexity = this.analyzeComplexity(text);
// Выбор оптимального переводчика
let translator;
if (complexity.score < 0.3) {
translator = this.translators.google; // Бесплатно
} else if (complexity.hasCode || complexity.technical) {
translator = this.translators.gpt4mini; // Точность
} else if (complexity.creative) {
translator = this.translators.claude; // Креатив
} else {
translator = this.translators.deepl; // Универсал
}
// Перевод с отслеживанием затрат
const result = await translator.translate(text);
this.stats.log(translator.name, text.length, result.cost);
return result;
}
}Мониторинг и аналитика
Дашборд для отслеживания расходов:
# Flask приложение для мониторинга
from flask import Flask, jsonify
import pandas as pd
app = Flask(__name__)
@app.route('/api/usage-stats')
def usage_stats():
# Получение данных из БД
usage_data = fetch_usage_data()
# Аналитика по сервисам
stats = {
'total_cost': sum(usage_data['cost']),
'by_service': usage_data.groupby('service')['cost'].sum().to_dict(),
'trend': calculate_trend(usage_data),
'forecast': forecast_next_month(usage_data),
'optimization_tips': generate_tips(usage_data)
}
return jsonify(stats)
def generate_tips(data):
tips = []
# Анализ паттернов использования
peak_hours = data.groupby('hour')['requests'].mean()
if peak_hours.max() > peak_hours.mean() * 2:
tips.append({
'type': 'load_balancing',
'message': 'Распределите нагрузку вне пиковых часов',
'potential_savings': '15-20%'
})
# Проверка эффективности моделей
cost_per_quality = data.groupby('model')['satisfaction'].mean()
if 'gpt-4' in cost_per_quality and cost_per_quality['gpt-4'] < 0.8:
tips.append({
'type': 'model_optimization',
'message': 'GPT-4 не оправдывает затраты, переключитесь на GPT-4o-mini',
'potential_savings': '60%'
})
return tipsБудущее Immersive Translate и API интеграций
Технологические тренды
Мультимодальный перевод:
- Перевод изображений прямо на странице
- Синхронный перевод видео без субтитров
- AR перевод через камеру смартфона
AI агенты для перевода:
- Автономные агенты, адаптирующиеся под стиль
- Обучение на корпоративных данных
- Персональные переводческие профили
Edge computing:
- Локальные модели прямо в браузере
- Offline перевод через WebAssembly
- Приватность без компромиссов
Развитие экосистемы
Ожидаемые изменения:
- Стандартизация API — единый протокол для всех сервисов
- Федеративное обучение — улучшение моделей без утечки данных
Российский рынок: особый путь
Развитие отечественных решений:
- YandexGPT и GigaChat для специализированных доменов через собственные API
- Поддержка региональных языков РФ
Импортозамещение с умом:
- Гибридные решения (российские + мировые модели)
- Соверенные облака для критичной инфраструктуры
- Open-source альтернативы с локализацией
Практическое руководство: запуск за 15 минут
Шаг 1: Быстрая регистрация (2 минуты)
Если используете шлюз, зарегистрируйтесь на https://api.laozhang.ai/register/ и создайте API-ключ в личном кабинете. Если ключ OpenAI у вас уже есть, этот шаг не нужен.
Шаг 2: Установка расширения (3 минуты)
Установите расширение из магазина своего браузера (ссылки — на официальном сайте) и закрепите его иконку на панели.
Шаг 3: Минимальная конфигурация (5 минут)
// Копируем в настройки расширения
const quickConfig = {
"openai": {
"apiKey": "ВАШ_API_КЛЮЧ",
"apiUrl": "https://api.laozhang.ai/v1/chat/completions",
"model": "gpt-4o-mini"
},
"autoTranslate": true,
"targetLanguage": "ru",
"displayMode": "bilingual"
};Шаг 4: Первый перевод (5 минут)
- Откройте любую англоязычную статью
- Нажмите иконку расширения
- Выберите "Перевести страницу"
- Наблюдайте магию двуязычного отображения
Заключение: новая эра доступности контента
Immersive Translate с правильно настроенным API заметно упрощает работу с иноязычным контентом. Главное — помнить, что сам он API не предоставляет: качество и стоимость перевода определяет подключённый сервис.
Для пользователей, у которых нет прямого доступа к API OpenAI или Anthropic, вариантом остаётся API-шлюз вроде laozhang.ai с поддержкой на русском языке; актуальные цены и условия смотрите на сайте сервиса.
Начните с малого: установите Immersive Translate, подключите ключ и проверьте перевод на короткой странице, прежде чем переводить длинные документы.
Полезные ссылки:






