Чистые провайдеры перевода
Что такое чистый провайдер перевода, какие из них поддерживает Read Frog, что нужно каждому и когда выбрать такого вместо LLM-провайдера.
Что такое чистый провайдер перевода
Чистый провайдер перевода делает одно: вы посылаете ему текст, он присылает перевод. Ни модели на выбор, ни промпта, который надо писать, ни диалога. Read Frog собирает их в группу Чистые провайдеры перевода в Настройки → API-провайдеры → Добавить провайдера.
LLM-провайдер переводит потому, что его об этом попросили. Именно этот дополнительный шаг и делает возможными контекст страницы, ваши собственные формулировки промпта и ваш глоссарий — и он же объясняет, почему это стоит больше токенов и обычно занимает больше времени.
Чего они не умеют
Чистых провайдеров перевода можно назначить на перевод страниц, субтитры к видео, перевод с панели выделения и перевод ввода. Они не могут нести ничего, что зависит от промпта:
- Умный контекст ИИ обогащать нечем, поэтому для этих провайдеров настройка ничего не делает.
- Пользовательские промпты страниц во всплывающем окне становятся неактивными, когда выбранный провайдер не является LLM.
- Пользовательские AI-действия и подсказки для заметок требуют LLM-провайдера и такого не примут.
- ИИ-сегментация субтитров пропускается; субтитры переводятся по одной реплике по мере поступления.
- Термины глоссария игнорируются. Глоссарий едет внутри системного промпта, поэтому доходит только до LLM-перевода.
Если глоссарий вдруг перестал действовать на странице, проверьте, каким провайдером пользуется эта функция. Каждая функция выбирает провайдера сама, поэтому перевод страниц может быть на DeepL, пока ваша панель выделения всё ещё на LLM.
Провайдеры в этой группе
DeepL
Официальный API DeepL. Ему нужен API-ключ и больше ничего — поля Base URL нет, потому что Read Frog определяет endpoint Free или Pro по форме вашего ключа. Подробности и обработку языковых кодов см. в DeepL.
DeepLX
Неофициальный DeepL-совместимый API. Ему нужен Base URL, а API-ключ — только если ваш экземпляр его требует, поэтому бесплатный публичный экземпляр работает с пустым полем ключа. Base URL может содержать подстановку {{apiKey}}, если ваш провайдер ждёт токен где-то помимо пути. См. DeepLX.
Google Translate и Microsoft Translator
Они относятся к тому же семейству, но настройки не требуют вообще: они поставляются уже добавленными и включёнными, заполнять учётные данные не нужно, и удалить их нельзя. Именно поэтому вы не найдёте их в диалоге Добавить провайдера.
Microsoft Translator нельзя совмещать с режимом страницы «Только перевод». Его endpoint не сохраняет разметку, поэтому Read Frog блокирует эту комбинацию, а не позволяет ей испортить страницу.
Как добавить и включить
Нажмите Добавить провайдера и выберите провайдера из группы Чистые провайдеры перевода.
Заполните поля, которые показывает этот провайдер: API-ключ для DeepL, Base URL (и при необходимости ключ) для DeepLX.
Включите переключатель Включено, затем назначьте провайдера на функцию в разделе Провайдеры функций.
Добавленный, но не включённый провайдер не появится в выборе провайдеров для функций. Назначение его на функцию из его же редактора включает его за вас.
Проверка соединения
Проверить соединение — это не пинг: оно переводит слово Hi через ваши настоящие настройки, поэтому зелёная галочка означает, что именно эта конфигурация дала перевод.
- Зелёная галочка означает успех; песочные часы — что всё получилось, но заняло больше трёх секунд.
- Красный крестик означает, что запрос провалился. Причина на кнопке не показывается, поэтому попробуйте перевод на настоящей странице, чтобы увидеть текст ошибки.
- Кнопка неактивна, пока поле API-ключа пусто, — кроме DeepLX, которому разрешено работать без ключа.
- Результат пропадает через несколько секунд и сбрасывается сразу же, как только вы правите провайдера, ключ или URL, — поэтому устаревшая галочка никогда не поручится за конфигурацию, которую вы с тех пор изменили.
Когда выбирать такого провайдера
Выбирайте чистого провайдера перевода, когда:
- Вы переводите длинные страницы или целые дорожки субтитров и хотите наименьшую задержку на запрос.
- Вам нужна предсказуемая стоимость. DeepL берёт плату за символы, а не за токены, а бесплатный ключ DeepL или публичный экземпляр DeepLX не стоят ничего.
- Ваша LLM-квота невелика, и вы предпочли бы тратить её на пользовательские AI-действия, а не на массовый перевод страниц.
Оставайтесь на LLM-провайдере, когда:
- Вы опираетесь на глоссарий, свой промпт или умный контекст ИИ.
- Тексту нужно суждение, а не буквальная точность — идиомы, шутки, профессиональный жаргон.
- Вы хотите, чтобы один провайдер обслуживал и перевод, и функции ИИ, вместо того чтобы содержать двух.
Хорошая золотая середина — держать перевод страниц на чистом провайдере перевода, а панель выделения на LLM: тогда быстрый путь дешёв, а внимательный по-прежнему доступен для тех слов, на которых вы останавливаетесь.
Устранение неполадок
«DeepL API key is not configured»
Поле API-ключа пусто. Режима без ключа у DeepL нет.
«DeepL translation request failed» или «DeepLX translation request failed»
Провайдер ответил ошибочным статусом. Read Frog дописывает к этому сообщению код статуса и собственное тело ошибки провайдера, и прочитать это обычно быстрее всего. Обычные причины — неверный или истёкший ключ, ключ, не соответствующий тарифу, и исчерпанная квота символов.
«API key is required when using {{apiKey}} placeholder in DeepLX baseURL»
В вашем Base URL есть подстановка, но поле API-ключа пусто. Либо заполните ключ, либо уберите подстановку из URL.
«Unexpected response format from DeepLX translation API»
Запрос прошёл, но тело ответа оказалось не тем, что возвращает экземпляр DeepLX. Read Frog ожидает JSON, где перевод лежит в строковом поле data. Публичные экземпляры, перепрофилированные или спрятанные за страницей входа, часто падают здесь.
«Network error during DeepL/DeepLX translation»
Запрос вообще не дошёл до сервера: экземпляр выключен, хост не разрешается или его CORS-заголовки отклоняют расширение. Самостоятельно размещённые экземпляры должны быть доступны из браузера, а не только из вашего терминала.
Переводы нормальные, но термины неверны
На этих провайдерах так и должно быть — см. «Чего они не умеют» выше. Переведите эту функцию на LLM-провайдера, если глоссарий важнее скорости.
Связанные страницы
Настройка провайдеров и API Key · DeepL · DeepLX · Настройка встроенных провайдеров · Пользовательские OpenAI-совместимые провайдеры