diff --git a/docs/web-test-recording-guide.md b/docs/web-test-recording-guide.md index 95ddebf2..59f3f555 100644 --- a/docs/web-test-recording-guide.md +++ b/docs/web-test-recording-guide.md @@ -198,20 +198,56 @@ await showCaption('Технические детали', { speech: false }); - **Технических данных** — показать, но не зачитывать - **Информационных плашек** — немой субтитр на несколько секунд -## Доступные голоса +## Доступные голоса и провайдеры -### Edge TTS (бесплатный) +### Какой провайдер выбрать? + +| Контент | Рекомендация | Почему | +|---------|-------------|--------| +| **Русскоязычный** | Edge TTS (DmitryNeural / SvetlanaNeural) | Правильные ударения, естественная интонация, верные смысловые акценты | +| **Англоязычный / мультиязычный** | ElevenLabs | Менее «роботизированный» тембр, хорошая мультиязычная модель | +| **OpenAI-совместимый сервис** | OpenAI | Если уже есть API-ключ или свой TTS-сервер | + +**Для русскоязычных видеоинструкций рекомендуется Edge TTS** — он бесплатный и даёт лучшее качество русской речи. Голоса DmitryNeural и SvetlanaNeural специально обучены для русского языка: правильно расставляют ударения, делают паузы в нужных местах и выделяют ключевые слова. ElevenLabs при озвучке русского текста звучит «через английский» — тембр приятнее, но акцент и просодика хуже. + +### Edge TTS (бесплатный) — рекомендуется для русского | Голос | Описание | |-------|----------| -| `ru-RU-DmitryNeural` | Мужской, русский | -| `ru-RU-SvetlanaNeural` | Женский, русский | +| `ru-RU-DmitryNeural` | Мужской, русский — спокойный, деловой | +| `ru-RU-SvetlanaNeural` | Женский, русский — чёткий, уверенный | Полный список: `en-US-AriaNeural`, `en-US-GuyNeural`, `de-DE-ConradNeural` и другие. Edge TTS поддерживает десятки языков. -### OpenAI-compatible (платный) +Конфигурация не нужна — Edge TTS используется по умолчанию. Для смены голоса: -Конфигурация в `.v8-project.json`: +```json +{ + "tts": { + "voice": "ru-RU-SvetlanaNeural" + } +} +``` + +### ElevenLabs (платный) — для английского и мультиязычного контента + +Модель `eleven_multilingual_v2` поддерживает русский, но лучшие результаты — на английском. Тембр менее синтетический, чем у Edge TTS. + +```json +{ + "tts": { + "provider": "elevenlabs", + "apiKey": "sk_...", + "voice": "onwK4e9ZLuTAKqWW03F9" + } +} +``` + +`voice` — ID голоса из библиотеки ElevenLabs (не имя). Список голосов — в личном кабинете. Требуется платный тариф (starter и выше). + +Особенности: лимит на параллельные запросы (2–3 одновременно), система автоматически ограничивает размер пакета. + +### OpenAI-compatible (платный) ```json { @@ -225,23 +261,7 @@ await showCaption('Технические детали', { speech: false }); Голоса: `alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`. -Поле `apiUrl` позволяет подключить любой OpenAI-совместимый сервис. - -### ElevenLabs (платный) - -Высокое качество синтеза, мультиязычная модель поддерживает русский. - -```json -{ - "tts": { - "provider": "elevenlabs", - "apiKey": "sk_...", - "voice": "JBFqnCBsd6RMkjVDRZzb" - } -} -``` - -`voice` — это ID голоса из библиотеки ElevenLabs (не имя). Список голосов — в личном кабинете ElevenLabs. Требуется платный тариф для использования через API. +Поле `apiUrl` позволяет подключить любой OpenAI-совместимый сервис (например, локальный TTS-прокси). ## Полный пример