Перейти к содержанию

Immersive Translate API: как подключить свой API-ключ к расширению

Immersive Translate — не API, а расширение и приложения для перевода с 20+ движками. Как подключить свой ключ OpenAI или API-шлюз, какие модели выбрать и как избежать лимитов.

•••7 мин чтения•AI-инструменты
Immersive Translate - интеграция API для двуязычного перевода веб-страниц

Обновление (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 выводит эту функцию на профессиональный уровень:

  1. Двуязычное отображение — оригинал и перевод видны одновременно
  2. Выбор движка перевода — более 20 движков, включая ChatGPT, DeepL, DeepSeek и Gemini
  3. Контекстный перевод — учитывает окружающий текст для точности
  4. Настройка под домен — разные движки для разных сайтов
  5. Перевод защищенного контента — работает там, где обычные переводчики бессильны

Архитектура: как расширение работает с API

Архитектура интеграции API в Immersive Translate

Поток данных при переводе

  1. Захват контента — расширение анализирует DOM страницы
  2. Сегментация — текст разбивается на оптимальные блоки
  3. API запрос — отправка на выбранный сервис перевода
  4. Обработка ответа — получение и форматирование перевода
  5. Инъекция в страницу — вставка перевода с сохранением стилей

Поддерживаемые API и их особенности

OpenAI:

  • Хорошее качество для технических текстов
  • Понимание контекста и терминологии
  • Нужен ключ API OpenAI, а не подписка ChatGPT
  • Актуальные модели и цены: список моделей и страница цен

DeepL:

  • Сильная сторона — европейские языки
  • Естественность перевода
  • Цены — на сайте DeepL

Google Translate:

  • Максимальная скорость
  • Поддержка редких языков
  • Базовое качество для сложных текстов

Claude (Anthropic), Gemini, DeepSeek:

  • Подходят для литературных текстов и сохранения стиля
  • Подключаются своим ключом соответствующего провайдера
  • Цены — на страницах провайдеров

Локальные модели:

  • LibreTranslate для приватности
  • Работа без интернета
  • Настройка под специфические задачи
  • Бесплатно после настройки

Проблема доступа для российских пользователей

С марта 2022 года российские пользователи столкнулись с каскадом ограничений:

Технические блокировки

  1. IP-фильтрация — OpenAI, Anthropic, DeepL блокируют российские адреса
  2. Платежные ограничения — невозможность оплаты российскими картами
  3. Аккаунтные проверки — требование зарубежного номера телефона
  4. Cloudflare проверки — дополнительная защита от российского трафика

Юридические риски

Использование VPN для обхода создает проблемы:

  • Нарушение условий использования сервисов
  • Риск блокировки корпоративных аккаунтов
  • Неопределенность правового статуса
  • Сложности с налоговым учетом

Экономические последствия

Даже при наличии доступа, российские компании сталкиваются с:

  • Завышенными комиссиями при конвертации валюты
  • Необходимостью содержать зарубежные юрлица
  • Дополнительными расходами на инфраструктуру обхода

Вариант с API-шлюзом laozhang.ai

laozhang.ai — API-шлюз, через который модели разных провайдеров доступны по одному ключу в формате OpenAI API.

Как это работает технически

  1. Единый endpoint — все запросы идут через api.laozhang.ai
  2. Прозрачная проксификация — сохранение оригинального API формата
  3. Интеллектуальная маршрутизация — выбор оптимального сервера
  4. Кэширование — экономия на повторных запросах
  5. Мониторинг доступности — автоматическое переключение при сбоях

Экономическая модель

Сравнение стоимости использования API

Стоимость перевода зависит от выбранной модели и объёма текста. Прежде чем выбирать между прямым API провайдера и шлюзом, сравните актуальные цены на сайтах обоих.

Что ещё учитывать:

  • Способ оплаты, доступный вам
  • Нужны ли вам VPN и зарубежная карта для прямого доступа
  • Расходы на конвертацию валюты

Пошаговая настройка: от регистрации до первого перевода

Шаг 1: Регистрация на laozhang.ai

bash
# Переход на страницу регистрации
https://api.laozhang.ai/register/

Процесс регистрации:

  1. Введите email или используйте TG
  2. Подтвердите почту (письмо приходит за 1-2 минуты)
  3. Заполните профиль (опционально)
  4. Получите API ключ в личном кабинете

Шаг 2: Установка Immersive Translate

Для Chrome/Edge:

javascript
// Прямая ссылка на Chrome Web Store
https://chrome.google.com/webstore/detail/immersive-translate/bpoadfkcbjbfhfodiogcnhhhpibjhbnh

// Альтернативная установка через ZIP (для РФ)
https://github.com/immersive-translate/immersive-translate/releases

Для Firefox:

javascript
// Firefox Add-ons
https://addons.mozilla.org/firefox/addon/immersive-translate/

// Проверка после установки
about:debugging#/runtime/this-firefox

Шаг 3: Настройка API в расширении

Базовая конфигурация для OpenAI:

  1. Откройте настройки расширения (иконка в панели браузера → ⚙️)
  2. Перейдите в "Сервисы перевода" → "OpenAI"
  3. Введите API-ключ; адрес стороннего API указывается в разделе «More Settings» (в официальном примере это полный адрес, заканчивающийся на /chat/completions). Несколько ключей можно ввести через запятую для балансировки нагрузки:
javascript
// Конфигурация для 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 для мультиязычных сайтов

javascript
// 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 для мобильных приложений

kotlin
// 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 секунд

Решения:

  1. Переключитесь на более быстрый сервис (Google Translate)
  2. Уменьшите размер блоков перевода в настройках
  3. Используйте кэширование для повторяющегося контента
  4. При частых ошибках 429 снизьте максимальное число запросов в секунду в настройках сервиса: Immersive Translate для OpenAI советует около 5 запросов в секунду
  5. Если используете API-шлюз, проверьте задержку до его сервера

Проблема 2: Неточный перевод терминологии

Решение через кастомные промпты:

javascript
// Настройка глоссария для домена
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

Стратегии оптимизации:

python
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: Блокировка аккаунта

Превентивные меры:

  1. Не превышайте 80% от заявленных лимитов
  2. Распределяйте нагрузку по времени
  3. Используйте несколько API ключей для балансировки
  4. Мониторьте использование через дашборд

Оптимизация затрат: практические советы

Выбор оптимальной модели

Матрица принятия решений:

Тип контентаРекомендуемый вариант
Новости, блогиGoogle Translate или DeepL
Техническая документациянедорогая модель OpenAI или другого провайдера
Юридические текстыстаршая модель с глоссарием в промпте
Маркетинг, креативмодель, сильная в стиле (например, Claude)
Простые UI элементылокальные модели

Цены моделей меняются часто, поэтому сравнивайте их по актуальным страницам провайдеров.

Гибридная стратегия

javascript
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;
    }
}

Мониторинг и аналитика

Дашборд для отслеживания расходов:

python
# 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
  • Приватность без компромиссов

Развитие экосистемы

Ожидаемые изменения:

  1. Стандартизация API — единый протокол для всех сервисов
  2. Федеративное обучение — улучшение моделей без утечки данных

Российский рынок: особый путь

Развитие отечественных решений:

  • YandexGPT и GigaChat для специализированных доменов через собственные API
  • Поддержка региональных языков РФ

Импортозамещение с умом:

  • Гибридные решения (российские + мировые модели)
  • Соверенные облака для критичной инфраструктуры
  • Open-source альтернативы с локализацией

Практическое руководство: запуск за 15 минут

Шаг 1: Быстрая регистрация (2 минуты)

Если используете шлюз, зарегистрируйтесь на https://api.laozhang.ai/register/ и создайте API-ключ в личном кабинете. Если ключ OpenAI у вас уже есть, этот шаг не нужен.

Шаг 2: Установка расширения (3 минуты)

Установите расширение из магазина своего браузера (ссылки — на официальном сайте) и закрепите его иконку на панели.

Шаг 3: Минимальная конфигурация (5 минут)

javascript
// Копируем в настройки расширения
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 минут)

  1. Откройте любую англоязычную статью
  2. Нажмите иконку расширения
  3. Выберите "Перевести страницу"
  4. Наблюдайте магию двуязычного отображения

Заключение: новая эра доступности контента

Immersive Translate с правильно настроенным API заметно упрощает работу с иноязычным контентом. Главное — помнить, что сам он API не предоставляет: качество и стоимость перевода определяет подключённый сервис.

Для пользователей, у которых нет прямого доступа к API OpenAI или Anthropic, вариантом остаётся API-шлюз вроде laozhang.ai с поддержкой на русском языке; актуальные цены и условия смотрите на сайте сервиса.

Начните с малого: установите Immersive Translate, подключите ключ и проверьте перевод на короткой странице, прежде чем переводить длинные документы.


Полезные ссылки:

Нашли ошибку или столкнулись с проблемой, которой нет в статье? Отправьте адрес статьи и описание на hi@laozhang.ai. Мы проверим и обновим текст.