Введение
Передайте video_url записи до 15 минут и выберите язык её речевой дорожки. Эндпоинт вернёт MP4 с заменённым звуком при неизменных изображении и движениях губ. Субтитры не включены.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Разработчик и продукт | ElevenLabs — ElevenLabs Dubbing |
| Дата выпуска | 10 октября 2023 |
| Публичное имя аудио API | elevenlabs/dubbing/audio-to-audio |
| Публичное имя видео API | elevenlabs/dubbing/video-translate |
| Предел длительности исходника | 15 минут; более длинные записи отклоняются при отправке |
| Целевые языки | 33; |
| Исходные языки | 57 плюс автоопределение |
| Количество говорящих | 1–32; опустите |
| Фоновый звук |
|
| Наблюдавшийся аудиорезультат | MP3; 4,50 с, моно 44,1 кГц, 128 кбит/с в нашем аудиотесте |
| Наблюдавшийся видеорезультат | MP4; 6,04 с с новым моно AAC и побайтово идентичным видеопотоком в нашем тесте |
| Единица оплаты | Секунды исходного медиа с округлением вверх |
Ключевые возможности и особенности
Дубляж в MP3 или переведённый MP4
audio-to-audio принимает запись и возвращает MP3 с дубляжом. video-translate создаёт MP4 с сохранённой картинкой и заменённой аудиодорожкой. Оба принимают исходники до 15 минут: выбирайте эндпоинт по нужному итоговому медиа.
33 целевых языка и определение голосов
Выберите из 33 целевых и 57 исходных языков либо включите автоматическое определение исходного. При известном составе задайте speaker_count от 1 до 32, иначе опустите его. По словам ElevenLabs, дубляж переносит характер каждого голоса в переведённую речь.
Оставьте атмосферу исходной записи
Включите keep_background_audio, если музыка или атмосфера нужны в переводе. До использования результата проверьте их баланс с новыми голосами. Для видео этот выбор не меняет снятое изображение и не создаёт субтитры.
9,6 с обработки нашего аудиообразца
Тест перевода английского аудио на 4,5 с на испанский дал MP3 на 4,50 с примерно за 9,6 с обработки. Файл — моно 44,1 кГц, 128 кбит/с. Отдельное видео на 6,04 с заняло около 14,8 с и вернулось MP4 с новой монофонической AAC-дорожкой; это наблюдения по образцам.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Укажите видео до 15 минут, речевую дорожку которого нужно перевести. Более длинный исходник разделите до отправки; результат сохранит картинку и заменит аудиодорожку. Не менее 1 символов |
target_language | Нет | Выберите один из 33 языков дубляжа дорожки; по умолчанию en. Для пробного перевода с английского на испанский укажите es. |
source_language | Нет | Для определения языка речи используйте auto либо задайте один из 57 исходных языков. Выберите известный язык, если для пробного дубляжа нужна явная настройка. |
speaker_count | Нет | Укажите число разных говорящих от 1 до 32 либо оставьте поле незаданным для автоопределения. Проверяйте переведённую дорожку при каждой смене говорящего. |
keep_background_audio | Нет | Включите настройку, если музыка и атмосфера видео должны остаться под новым диалогом. Она касается звука и не меняет картинку или движения губ. По умолчанию: |
Стоимость
$0.012 / секунда
Исходный клип тарифицируется посекундно с округлением дробных секунд вверх; принимаются записи до 15 минут. Язык и число говорящих не меняют ставку, а неудачная задача не оплачивается.
Сценарии использования
Подкаст-интервью на испанском
Отправьте 12-минутное английское интервью через audio_url, выберите es и задайте speaker_count 2 для ведущего и гостя. Аудиоэндпоинт вернёт переведённый MP3 для проверки и включения в испанский выпуск.
Голосовое сообщение клиентам на английском
Предоставьте 45-секундную заметку коллеги, согласившегося на перевод, с целевым en. Получите MP3 с дубляжом и проверьте его, прежде чем делиться сообщением.
Озвученный урок с сохранённым экраном
Передайте 6-минутную запись урока с экрана через video_url и выберите целевой язык. MP4 сохранит демонстрацию, заменив речь; при необходимости подготовьте субтитры отдельно.
Аудиореклама с музыкой
Используйте 30-секундную рекламу, на которую имеете права, и включите keep_background_audio. Получится MP3 с переведёнными голосами и сохранённой под ними музыкой или атмосферой.
Демонстрация продукта для другого рынка
Отправьте 90-секундный обзор продукта как видео и выберите поддерживаемый язык. MP4 с тем же изображением и дубляжом подойдёт для языковой проверки перед выпуском.
Руководство по промптам и практические советы
Подберите запись с разрешением на дубляж
Выберите аудио или видео не длиннее 15 минут: собственную запись либо говорящих, согласившихся на дубляж. Убедитесь в наличии прав на речь и музыку.
Настройте языки и говорящих
Выберите один из 33 целевых языков и автоопределение либо один из 57 исходных. Если известно, укажите
speaker_countот 1 до 32 и решите, сохранять ли фон.Создайте запрос на дубляж
Выполните POST https://api.spicyapi.ai/api/v1/jobs/createTask с авторизацией Bearer и JSON, например {"model":"elevenlabs/dubbing/audio-to-audio","input":{"
audio_url":"https://example.com/narration.mp3","target_language":"es"}}. Для видео выберите elevenlabs/dubbing/video-translate и замените поле наvideo_url.Получите медиа и проверьте перевод
Читайте задачу через GET /api/v1/jobs/recordInfo?taskId= до state succeeded, затем скачайте возвращённый файл. Проверьте речь и смену говорящих; в дубляже видео движения губ остаются снятыми.
ElevenLabs Dubbing API для перевода видео
ElevenLabs Dubbing API заменяет речевую дорожку видео переводом и возвращает MP4 с исходной картинкой. Этот эндпоинт подходит для обзора продукта, записанного урока или озвученного клипа до 15 минут, когда снятое изображение должно сохраниться.
ElevenLabs заявляет, что её инструмент дубляжа сохраняет характеристики голоса при смене языка. Этот процесс не анимирует рот и не создаёт субтитры: планируйте такие требования отдельно.
Создание задачи перевода видео
Задайте публичное имя модели elevenlabs/dubbing/video-translate и поместите исходник в video_url. Отправьте этот JSON методом POST на https://api.spicyapi.ai/api/v1/jobs/createTask, добавив заголовки Authorization: Bearer <SPICY_API_KEY> и Content-Type: application/json.
{
"model": "elevenlabs/dubbing/video-translate",
"input": {
"video_url": "https://example.com/english-product-demo.mp4",
"target_language": "es",
"source_language": "en",
"speaker_count": 1,
"keep_background_audio": true
}
}
Пример переводит английскую речь одного ведущего на испанский с сохранением фона. Подставьте видео, на дубляж которого у вас есть разрешение, и удалите speaker_count, если предпочитаете автоопределение.
Получение файла MP4
Успешная задача возвращает переведённое видео файлом MP4 в результате задачи. Выполните GET /api/v1/jobs/recordInfo?taskId=<taskId> с полученным идентификатором и авторизацией; проверьте succeeded до использования ссылки скачивания.
{
"code": 200,
"data": {
"taskId": "<taskId>",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://example.com/spanish-product-demo.mp4",
"mime": "video/mp4"
}
]
}
}
}
В сокращённом ответе указан условный URL. Просматривайте скачанный MP4, оценивая речь и картинку вместе.
Входное видео и языковые варианты
Видеоэндпоинт принимает один исходник и приведённые ниже настройки языка, состава говорящих и фона.
| Поле | Поддерживаемая настройка | Действие в запросе |
|---|---|---|
video_url | Исходное видео до 15 минут | Предоставляет изображение и речевую дорожку |
target_language | 33 целевых языка; по умолчанию en | Определяет язык переведённой речи |
source_language | 57 исходных языков или auto | Задаёт язык речи или запрашивает определение |
speaker_count | Целое 1–32 или отсутствие поля | Передаёт известный состав или запрашивает определение |
keep_background_audio | Сохранение музыки и атмосферы | Оставляет фон под переведёнными голосами |
Исходник длиннее 15 минут отклоняется при отправке. Длинную обучающую запись разделите по границам уроков и упорядочьте части для проверки и последующей сборки.
Сохранение картинки и выбор процесса
Эндпоинт сохраняет картинку и меняет дорожку, не изменяя синхронизацию губ и не создавая субтитры. Для съёмки говорящего человека это существенно: видимый рот продолжает исходные движения, хотя голос звучит на другом языке.
| Процесс | Вход и выход | Причина выбора |
|---|---|---|
| ElevenLabs Dubbing audio-to-audio | Аудио в MP3 с дубляжом | Подкаст, дикторский текст или голосовая заметка |
| ElevenLabs Dubbing video-translate | Видео в MP4 с дубляжом | Переведённая речь при сохранённой картинке |
| HeyGen Video Translate | Перевод видео с движениями губ | Материал, которому нужно изменение движений губ |
| Video Translator V1 | Перевод видео | Другой вариант для видеоисходника |
Эти альтернативы не измерялись в наших тестах ElevenLabs.
Оплата видеодубляжа
Единица тарификации — секунда исходного видео, дробные секунды округляются вверх. При оценке задачи учитывайте ставку на странице и длительность исходного клипа.
Пробный фрагмент поможет оценить язык и переходы говорящих до отправки всего урока. Время его обработки не прогнозирует ожидание для более длинного исходника.
Что установил наш видеотест
Английское видео длительностью 6,04 с вернулось MP4 на 6,04 с примерно за 14,8 с обработки. Результат содержал новую монофоническую дорожку AAC, а видеопоток побайтово совпал с исходным.
Такое сравнение подтверждает сохранение картинки в проверенном клипе. Оно не измеряет точность перевода разных языков, не устанавливает время обработки длинных видео и не демонстрирует изменение движений губ.
Подготовка, проверка и решение проблем
До публикации дубляжа сверяйте переведённую речь со смыслом исходника и видимым контекстом. Например, в уроке о продукте должны сохраниться нужные названия функций и инструкции, несмотря на смену языка.
- Подтвердите права на видео, речь и музыку, а также согласие записанных говорящих.
- Выберите характерный отрывок со сменой говорящих или терминами для оценки.
- Задайте целевой и известный исходный язык либо используйте определение исходного.
- Укажите известное число говорящих и решите, нужна ли исходная атмосфера в дубляже.
- Посмотрите готовый MP4, проверяя смысл речи, баланс фона и неизменные движения губ.
Слишком длинное видео или число говорящих вне 1–32 нужно исправить перед новой отправкой. При неудаче изучите детали ошибки задачи и входные данные, не считая скачивание признаком готового дубляжа.
Для отдельного MP3 используйте родственный аудиоэндпоинт. Субтитры запланируйте отдельным этапом и никогда не используйте переведённый голос для имитации реального человека.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/dubbing/video-translate",
"input": {
"source_language": "auto",
"target_language": "en",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.




