Урок из полного доступа, первые уроки курса бесплатно Официальный курс ElevenLabs Cookbook на русском
Урок 05 · Текст · ~5 мин

Автоматический дубляж видео на другие языки

Урок 5 из 21 курса «ElevenLabs: примеры»: официальный курс ElevenLabs Cookbook (Илевен Лабс) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Прежде чем писать какой-либо код, вызовите навык /text-to-speech, чтобы изучить правильные паттерны ElevenLabs SDK.

В этом примере используется Dubbing Projects API (dubbing v2): проект содержит исходный медиафайл и его транскрипцию, а каждый языковой таргет (language target) создает один дублированный output на одном языке.

Защищенный POST endpoint, который запускает проект дубляжа из загруженной записи.

  • Считайте ELEVENLABS_API_KEY из process.env. Верните 500, если отсутствует.
  • Принимайте audio (File), targetLang (строка) и опциональный sourceLang (строка, по умолчанию auto) из FormData запроса.
  • Верните 400 при отсутствии или недействительности аудио, или при отсутствии targetLang.
  • Используйте ElevenLabsClient и вызовите client.dubbing.project.create({ file: audio, targetLanguage: targetLang, sourceLanguage: sourceLang === "auto" ? undefined : sourceLang, reference: "Browser dubbing demo" }). Ярлык targetLanguage также ставит в очередь языковой таргет, который начинает генерироваться автоматически, как только проект завершит транскрибирование.
  • Верните JSON { projectId, languageId }, считывая languageId из project.languageIds?.[0] ?? null.
  • Оборачивайте сбои в читаемые JSON-ошибки.

Защищенный GET endpoint, который возвращает объединенный статус проекта и языка для polling.

  • Считайте и проверьте projectId из параметров маршрута.
  • Вызовите client.dubbing.project.get(projectId). Статусы проекта: queued, preparing, processing, ready или failed.
  • Если у проекта есть языковой таргет (project.languageIds?.[0]), также вызовите client.dubbing.project.language.get(projectId, languageId). Статусы языка: queued, processing, completed, stale или failed.
  • Верните JSON с projectStatus, languageId и languageStatus.
  • Сохраняйте ответ компактным и удобным для клиентского polling.

Защищенный GET endpoint, который проксирует дублированный аудио output.

  • Считайте и проверьте projectId и languageId из параметров маршрута.
  • Вызовите client.dubbing.project.language.get(projectId, languageId). Как только язык будет completed, outputs.losslessAudio содержит подписанный URL для скачивания, который истекает примерно через час; повторный запрос языка вернет новый.
  • Верните 503 с читаемой JSON-ошибкой, если язык еще не completed или не имеет URL output.
  • Запросите подписанный URL на стороне сервера и передайте тело обратно с исходным content type (по умолчанию audio/wav).

Страница для…

План урока

  1. 1. app/api/dubbing/route.ts
  2. 2. app/api/dubbing/[projectId]/route.ts
  3. 3. app/api/dubbing/[projectId]/audio/[languageId]/route.ts
  4. 4. app/page.tsx

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Откройте полный доступ

Вы прошли бесплатные уроки. Выберите тариф, чтобы продолжить обучение.

Курсы ElevenLabs 1 490 ₽ Разовый платёж, навсегда
  • Все курсы от ElevenLabs (1 шт.)
  • Именной сертификат по каждому пройденному курсу
Оплатить
Полный доступ 4 900 ₽ Разовый платёж, навсегда
  • Все 77 курсов от 11 AI-провайдеров
  • Библиотека промптов и новые курсы
Оплатить

Безопасная оплата через Robokassa: СБП, карты, электронные кошельки. Доступ откроется в этом браузере и придёт письмом. Уже оплатили? Восстановить доступ

Полезные гиды