📚 Документация

← Назад

📖 Введение

Busya Translate - это современное веб-приложение для перевода текста с использованием нейронных сетей и AI-преподавателя для обучения языкам. Приложение использует передовые технологии машинного обучения для обеспечения высококачественных переводов и интерактивного обучения.

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

✨ Основные возможности

  • Нейросетевой перевод: Быстрый нейросетевой перевод с помощью Yandex Translator API. Поддержка более 100 языков мира с автоматическим определением исходного языка.
  • AI Преподаватель: AI преподаватель с поддержкой нескольких моделей. Интерактивный чат-бот для изучения языков, практики грамматики и получения ответов на вопросы.
  • Экспорт результатов: Экспорт переводов в различных форматах (TXT, JSON, HTML, Python). Сохранение переводов для дальнейшего использования и анализа.
  • Многоязычный интерфейс: Многоязычный интерфейс с поддержкой русского, английского, испанского, французского и немецкого языков.
  • Адаптивный дизайн: Адаптивный дизайн для мобильных устройств. Оптимизация для различных размеров экранов и ориентаций.
  • Обмен языками: Быстрая смена направления перевода одной кнопкой.
  • Очистка текста: Удобные кнопки для очистки полей ввода и вывода.
  • Счетчик символов: Отслеживание длины введенного текста в реальном времени.

🤖 Доступные модели AI

Приложение поддерживает три мощные модели искусственного интеллекта через OpenRouter API:

  • Busya AI 1 - Продвинутая модель для общего использования. Идеально подходит для повседневных задач, общих вопросов и быстрых ответов. Отличается высокой скоростью работы и эффективностью.
  • Busya AI 2 - Модель для сложных рассуждений и обучения. Специализируется на глубоком анализе, сложных рассуждениях и образовательных задачах. Рекомендуется для изучения сложных тем и получения развернутых объяснений.
  • Busya AI 3 - Последняя модель GPT с улучшенными возможностями. Новейшая версия GPT с расширенными возможностями понимания контекста, генерации текста и многоязычной поддержки. Обеспечивает наиболее качественные и точные ответы.

Выбор модели: Вы можете переключаться между моделями в настройках AI преподавателя. Каждая модель имеет свои преимущества в зависимости от типа задачи.

📝 Подробное руководство по использованию

1. Перевод текста
  1. Введите текст для перевода в левое поле. Можно вводить текст вручную или вставить из буфера обмена (Ctrl+V или Cmd+V).
  2. Выберите исходный и целевой языки из выпадающих списков. Для автоматического определения языка выберите "Автоопределение" в поле исходного языка.
  3. Нажмите кнопку "Перевести" или используйте сочетание клавиш Ctrl+Enter (Windows/Linux) или Cmd+Enter (Mac).
  4. Переведенный текст появится в правом поле. Вы можете скопировать его, используя стандартные сочетания клавиш или кнопку очистки.
2. AI Преподаватель
  1. Используйте AI преподавателя для обучения и практики. Откройте секцию "🤖 AI Преподаватель" внизу страницы.
  2. Выберите модель AI и язык ответа из выпадающих списков в настройках чата.
  3. Введите ваш вопрос или запрос в поле ввода и нажмите кнопку отправки или клавишу Enter.
  4. AI ответит на вашем выбранном языке. Вы можете задавать вопросы о грамматике, лексике, произношении или любые другие вопросы, связанные с изучением языка.
  5. Модель "Busya AI 2" рекомендуется для сложных вопросов и развернутых объяснений, а "Busya AI 1" - для быстрых ответов.
3. Экспорт результатов
  1. Экспортируйте результаты в нужном формате. После получения перевода выберите формат экспорта из выпадающего списка (TXT, JSON, HTML, Python).
  2. Нажмите кнопку "Экспорт" для сохранения файла на ваше устройство.
  3. Формат TXT: Простой текстовый файл с оригинальным и переведенным текстом.
  4. Формат JSON: Структурированные данные с метаинформацией (языки, временная метка).
  5. Формат HTML: Красиво оформленная веб-страница с переводом.
  6. Формат Python: Python-скрипт с переменными, содержащими оригинальный и переведенный текст.
4. Дополнительные функции
  • Обмен языками: Нажмите кнопку со стрелками (↔) для быстрой смены направления перевода.
  • Очистка полей: Используйте кнопки с крестиком (✕) для очистки текста в полях ввода и вывода.
  • Счетчик символов: Следите за количеством символов в поле ввода внизу слева.
  • Сворачивание чата: Нажмите кнопку "−" в заголовке AI преподавателя для сворачивания/разворачивания секции чата.

🌍 Поддерживаемые языки

Приложение поддерживает перевод более чем на 100 языков, включая:

  • Европейские языки: Русский, Английский, Немецкий, Французский, Испанский, Итальянский, Португальский, Греческий, Польский, Чешский, Венгерский, Румынский, Голландский, Шведский, Норвежский, Датский, Финский и другие.
  • Азиатские языки: Китайский (упрощенный и традиционный), Японский, Корейский, Хинди, Арабский, Тайский, Вьетнамский, Индонезийский и другие.
  • Другие языки: Турецкий, Иврит, Персидский, Суахили, Африкаанс и многие другие.

Автоопределение языка: Приложение может автоматически определить исходный язык текста, что особенно удобно при работе с незнакомым контентом.

🔌 API Configuration

Приложение использует Yandex Cloud Translator API напрямую из браузера. Настройка API ключей выполняется в файле script.js:

Настройка API ключей

Откройте файл script.js и найдите секцию в начале файла:

// API Configuration
const YANDEX_API_KEY = ''; // Вставьте ваш Yandex API ключ
const YANDEX_FOLDER_ID = ''; // Опционально: ID каталога
const YANDEX_IAM_TOKEN = ''; // Опционально: IAM токен

Вставьте ваш API ключ между кавычками. Приложение будет автоматически использовать этот ключ для всех запросов к Yandex API.

Получение API ключа: Перейдите на cloud.yandex.ru, создайте сервисный аккаунт и получите API ключ для Yandex Translator API.

🛠️ Технологический стек

Приложение построено на современных и надежных технологиях:

  • Перевод: Yandex Translator API - Промышленный API для машинного перевода с поддержкой более 100 языков. Обеспечивает высокое качество переводов благодаря использованию нейронных сетей. API вызывается напрямую из браузера.
  • AI Чат: Puter.js + OpenRouter API - Интеграция с различными моделями AI через единый интерфейс. Поддержка моделей DeepSeek, OpenAI GPT-5, O3 и других.
  • Frontend: HTML5 + CSS3 + Vanilla JavaScript - Современный подход без зависимостей, обеспечивающий быструю загрузку и отзывчивость интерфейса. Полностью статическое приложение, готовое к публикации на любом статическом хостинге.
  • Стилизация: CSS Grid и Flexbox для адаптивной верстки, CSS переменные для темизации, медиа-запросы для мобильных устройств.
  • Локализация: Встроенная система i18n для поддержки множественных языков интерфейса.

⚙️ Установка и настройка

Требования
  • Современный веб-браузер (Chrome, Firefox, Safari, Edge)
  • Доступ в интернет для работы API
  • Yandex API ключ для работы переводчика
Установка
  1. Скачайте все файлы проекта (index.html, script.js, style.css, documentation.html)
  2. Откройте файл script.js в текстовом редакторе
  3. Найдите секцию "API Configuration" в начале файла
  4. Добавьте ваш Yandex API ключ в переменную YANDEX_API_KEY
  5. (Опционально) Добавьте YANDEX_FOLDER_ID и YANDEX_IAM_TOKEN если необходимо
Настройка API ключей

Для работы приложения необходимо настроить следующие API ключи в файле script.js:

  • YANDEX_API_KEY: API ключ Yandex Cloud для переводов. Получить можно на cloud.yandex.ru. Вставьте ключ в кавычки: const YANDEX_API_KEY = 'ваш-ключ-здесь';
  • YANDEX_FOLDER_ID: (опционально) ID каталога в Yandex Cloud
  • YANDEX_IAM_TOKEN: (опционально) IAM токен для аутентификации (если используется вместо API ключа)

Примечание: AI чат работает через Puter.js и OpenRouter, дополнительная настройка API ключей не требуется.

Запуск

Приложение готово к публикации на статическом хостинге. Просто загрузите файлы (index.html, script.js, style.css, documentation.html) на ваш хостинг. Приложение работает полностью на стороне клиента и не требует сервера.

💡 Советы и рекомендации

  • Качество переводов: Для лучших результатов переводите целые предложения или абзацы, а не отдельные слова. Контекст помогает улучшить качество перевода.
  • Выбор модели AI: Используйте "Busya AI 2" для сложных вопросов и развернутых объяснений, "Busya AI 1" для быстрых ответов, а "Busya AI 3" для наиболее точных и качественных ответов.
  • Экспорт данных: Регулярно экспортируйте важные переводы в формате JSON для сохранения метаданных (временные метки, языки) или в TXT для простого использования.
  • Мобильное использование: Приложение оптимизировано для мобильных устройств. Вы можете добавить его на главный экран для быстрого доступа.
  • Производительность: При работе с большими объемами текста разбейте его на части для более быстрой обработки.
  • Безопасность: Не передавайте конфиденциальную информацию через публичные API. Используйте приложение в защищенной сети.

🔧 Решение проблем

Проблемы с переводом
  • Ошибка "API ключ не настроен": Проверьте наличие и правильность Yandex API ключа в файле script.js. Убедитесь, что ключ вставлен между кавычками в переменной YANDEX_API_KEY
  • Ошибка "Translation failed": Проверьте подключение к интернету и доступность Yandex API. Убедитесь, что API ключ валиден и имеет права на использование Translator API
  • Неверный перевод: Убедитесь, что выбран правильный исходный язык. Попробуйте использовать "Автоопределение"
Проблемы с AI чатом
  • Чат не отвечает: Проверьте подключение к интернету. Puter.js требует активного соединения
  • Ошибка загрузки Puter.js: Проверьте, что ваш браузер не блокирует внешние скрипты. Обновите страницу (F5)
  • Медленные ответы: Некоторые модели (особенно "Busya AI 2") требуют больше времени для обработки сложных запросов
Проблемы с публикацией
  • Приложение не работает на хостинге: Убедитесь, что все файлы (index.html, script.js, style.css, documentation.html) загружены на хостинг. Проверьте, что API ключ правильно настроен в script.js
  • Ошибки CORS: Убедитесь, что в файлах index.html и documentation.html в Content-Security-Policy добавлен домен translate.api.cloud.yandex.net
  • API ключ виден в коде: Это нормально для статического хостинга. API ключ будет виден в исходном коде страницы. Для продакшена рекомендуется использовать прокси-сервер для защиты ключей

❓ Часто задаваемые вопросы

Общие вопросы

Q: Сколько языков поддерживает перевод?
A: Приложение поддерживает более 100 языков через Yandex Translator API.

Q: Можно ли использовать приложение офлайн?
A: Нет, приложение требует подключения к интернету для работы API переводов и AI чата.

Q: Бесплатно ли использование?
A: Приложение бесплатно, но использование Yandex API может требовать платной подписки после исчерпания бесплатного лимита. AI чат работает через Puter.js бесплатно.

Вопросы о моделях AI

Q: Какая модель лучше для изучения языка?
A: "Busya AI 2" рекомендуется для изучения языка, так как она лучше объясняет грамматику и правила. "Busya AI 3" обеспечивает наиболее точные ответы.

Q: Можно ли использовать несколько моделей одновременно?
A: Нет, в каждый момент времени активна только одна модель. Вы можете переключаться между моделями в настройках чата.

Технические вопросы

Q: Где хранятся переводы?
A: Переводы не сохраняются нигде. Все данные обрабатываются в реальном времени в вашем браузере и не передаются на сервер.

Q: Можно ли использовать API для интеграции с другими приложениями?
A: Да, вы можете использовать Yandex Translator API напрямую из вашего приложения. См. раздел "API Configuration" выше для примера использования.

📞 Контакты и поддержка

Если у вас возникли вопросы, проблемы или предложения по улучшению приложения:

  • Посетите наш Telegram канал: @busyapay
  • Следите за обновлениями и новыми проектами в нашем канале

Мы благодарим вас за использование Busya Translate!