DeepLX

Что такое DeepLX?

DeepLX — это бесплатная неофициальная версия API, которая обеспечивает качество перевода, подобное DeepL, посредством обратного проектирования. Он предлагает альтернативу официальному DeepL API для разработчиков, которым нужны высококачественные услуги перевода без дополнительных затрат.

Гибкая конфигурация BaseURL

Read Frog поддерживает гибкую конфигурацию baseURL DeepLX для работы с различными поставщиками DeepLX. Вы можете настроить baseURL в соответствии с форматом конечной точки вашего провайдера.

Поддержка заполнителя токена

Вы можете использовать заполнитель {{apiKey}} в своем baseURL, чтобы вставить токен API в любую позицию. Это полезно, когда разным поставщикам DeepLX требуются токены в разных форматах URL.

Примеры:

1. Токен в пути: https://api.deeplx.com/{{apiKey}}/translate
2. Токен как параметр запроса: https://api.deeplx.com/v1/translate?token={{apiKey}}
3. Токен в субдомене: https://{{apiKey}}.api.deeplx.com/translate

Специальная обработка URL-адресов

Стандартные URL-адреса DeepLX

Для большинства провайдеров DeepLX, если ваш baseURL не заканчивается на /translate, Read Frog автоматически добавит его:

• Ввод: https://deeplx.example.com
• Выход: https://deeplx.example.com/translate

С токеном API:

• Ввод: https://deeplx.example.com + токен abc123
• Выход: https://deeplx.example.com/abc123/translate

api.deeplx.org Специальная логика

Для официальной конечной точки https://api.deeplx.org Read Frog применяет специальную логику для вставки токена API между .org и /translate:

• Без токена: https://api.deeplx.org/translate
• С токеном: https://api.deeplx.org/your-token/translate

Примеры конфигурации

Токен API не требуется

Некоторые поставщики DeepLX не требуют аутентификации:

BaseURL: https://deeplx.vercel.app
API Key: (leave empty)
Result: https://deeplx.vercel.app/translate

Токен в пути

BaseURL: https://api.deeplx.com/{{apiKey}}
API Key: your-secret-token
Result: https://api.deeplx.com/your-secret-token/translate

Токен как параметр запроса

BaseURL: https://api.example.com/v1/translate?key={{apiKey}}
API Key: your-api-key
Result: https://api.example.com/v1/translate?key=your-api-key

Пользовательская конечная точка с токеном

BaseURL: https://deeplx.mydomain.com/api/{{apiKey}}/translate
API Key: abc123
Result: https://deeplx.mydomain.com/api/abc123/translate

Настройка DeepLX в Read Frog

1. Откройте параметры расширения: нажмите значок расширения Read Frog и перейдите в раздел «Параметры».
2. Перейдите к поставщикам API: перейдите в раздел «Поставщики API».
3. Настройте DeepLX:
   • Установите BaseURL в соответствии с форматом вашего провайдера.
   • При необходимости добавьте свой API Ключ (оставьте пустым для поставщиков, которым он не нужен)
   • Используйте заполнитель {{apiKey}}, если вам нужно индивидуальное размещение токена.
4. Тестовый перевод. Попробуйте перевести текст, чтобы убедиться, что конфигурация работает.

Распространенные поставщики DeepLX

Бесплатные провайдеры (без ключа API)

• https://deeplx.vercel.app
• https://deeplx.herokuapp.com

Платные /Self-hosted провайдеры

• https://api.deeplx.org (требуется ключ API)
• Ваш собственный локальный экземпляр

Устранение неполадок

Проблемы построения URL-адресов

Если у вас возникли проблемы с созданием URL-адреса:

1. Проверьте формат baseURL: убедитесь, что он соответствует ожидаемому шаблону.
2. Проверьте размещение токена: убедитесь, что {{apiKey}} находится в правильном положении.
3. Сначала протестируйте без токена: попробуйте воспользоваться бесплатным поставщиком, чтобы изолировать проблемы с конфигурацией.

Распространенные ошибки

• "Ключ API требуется при использовании заполнителя {{apiKey}}": вы указали {{apiKey}} в baseURL, но не предоставили ключ API.
• "Ошибка запроса на перевод DeepLX": проверьте правильность вашего baseURL и ключа API.
• Ошибки сети: убедитесь, что поставщик DeepLX доступен и находится в сети.

API Формат ответа

Поставщики DeepLX должны возвращать ответы JSON в следующем формате:

{
  "data": "translated text here"
}

Если вы настраиваете свой собственный экземпляр DeepLX, убедитесь, что он возвращает ответы в ожидаемом формате.