Введение
Переведите подкаст, голосовую заметку, закадровый текст или аудиорекламу, передав audio_url и целевой язык. Если известны, задайте исходный язык и число говорящих; выберите сохранение музыки и атмосферы. Результат — MP3 для прослушивания и проверки.
| Характеристика | Значение |
|---|---|
| Ввод | Аудио |
| Вывод | Аудио |
| Разработчик и продукт | 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-дорожкой; это наблюдения по образцам.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
audio_url | Да | Передайте запись для перевода через |
target_language | Нет | Выберите целевой язык из 33 поддерживаемых; по умолчанию en. Явно задайте значение, если нужен испанский или другой язык вместо английского. |
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 переводит аудиозапись в речь с дубляжом в MP3 на одном из 33 целевых языков. Эндпоинт предназначен для подкастов, голосовых заметок, закадрового текста и аудиорекламы с исходниками до 15 минут.
В документации дубляжа ElevenLabs заявляет о сохранении голосовых характеристик исходных говорящих. Проверяйте сходство на своём материале: короткий тест показывает формат вывода и наблюдавшуюся обработку, а не всестороннюю оценку перевода или голоса.
Отправка задачи аудиодубляжа
Передайте публичное имя модели elevenlabs/dubbing/audio-to-audio, поместив запись и языковые настройки в input. Отправьте следующий JSON методом POST на https://api.spicyapi.ai/api/v1/jobs/createTask с Authorization: Bearer <SPICY_API_KEY> и Content-Type: application/json.
{
"model": "elevenlabs/dubbing/audio-to-audio",
"input": {
"audio_url": "https://example.com/english-interview.mp3",
"target_language": "es",
"source_language": "en",
"speaker_count": 2,
"keep_background_audio": true
}
}
Иллюстративный запрос переводит английское интервью двух говорящих на испанский с сохранением фонового звука. Замените URL своей записью; опустите speaker_count, если хотите определять говорящих сервисом.
Чтение готового результата MP3
Завершённая задача предоставляет медиафайл с дубляжом в MP3. Используйте полученный taskId с GET /api/v1/jobs/recordInfo?taskId=<taskId> и той же авторизацией, затем проверьте состояние задачи перед скачиванием.
{
"code": 200,
"data": {
"taskId": "<taskId>",
"state": "succeeded",
"output": {
"assets": [
{
"url": "https://example.com/dubbed-interview.mp3",
"mime": "audio/mpeg"
}
]
}
}
}
Сокращённый ответ показывает структуру завершённой задачи; URL здесь условный. Созданная задача ещё не является готовой записью: дождитесь succeeded, прежде чем считать файл готовым.
Параметры и ограничения аудио
Аудиозапрос сочетает обязательную запись с выбором языка, говорящих и фона.
| Параметр | Допустимое значение или область | Применение |
|---|---|---|
audio_url | Исходное аудио до 15 минут | Передайте запись, которую имеете право переводить |
target_language | 33 языка; по умолчанию en | Задайте es для испанского результата |
source_language | auto или 57 исходных языков | Укажите известный язык либо используйте определение |
speaker_count | 1–32; опустите для определения | Посчитайте разных людей в интервью |
keep_background_audio | Переключатель сохранения фона | Оставьте музыку и атмосферу под голосами дубляжа |
Записи длиннее 15 минут отклоняются при отправке. Разделите длинный выпуск по смысловым темам или смене говорящих и проверьте стыки при сборке переведённых частей.
Тарификация по длительности исходника
Аудиодубляж оплачивается за секунды исходной записи с округлением вверх до целой секунды. Для бюджета записи смотрите цену на странице; ожидание обработки не является оплачиваемой длительностью медиа.
Расчёт основан на длине отправленного исходника, а не размере MP3. Для оценки незнакомого языка или сложного перехода между говорящими подготовьте короткий отрывок до отправки длинной записи.
Наш тест с английского на испанский
Английский исходник на 4,5 с вернулся испанским MP3 длительностью 4,50 с примерно за 9,6 с обработки. Вывод использовал частоту 44,1 кГц, один аудиоканал и кодирование 128 кбит/с.
Совпадение длительности относится к этому образцу и не доказывает одинаковый хронометраж любого перевода. Наблюдения также не устанавливают время обработки 15-минутного подкаста или результат для всех 33 целевых языков.
Подготовка записи и проверка дубляжа
Разборчивый диалог и явный план проверки помогут оценить пригодность перевода для аудитории. Возьмите характерный отрывок с важными для проекта именами, терминами или сменами говорящих.
- Выберите фрагмент с понятной речью и подтвердите разрешение говорящих.
- Задайте известный исходный язык, затем явно выберите целевой.
- Введите число разных говорящих, если оно известно, либо опустите его для определения.
- Решите, нужна ли фоновая музыка в итоговом материале, и настройте сохранение.
- Попросите слушателя, знающего целевой язык, проверить смысл, произношение и смену реплик.
Чистая дикторская запись не представляет интервью с одновременной речью. Прослушайте перебивания и сравните, кто произносит каждую переведённую реплику: число говорящих не заменяет такую проверку.
Устранение проблем и выбор другого процесса
Исправьте слишком длинный исходник или число говорящих вне диапазона до повторной отправки отклонённого запроса. Если задача завершилась неудачно, изучите ошибку и проверьте запись и языковые настройки перед новой попыткой.
Выберите elevenlabs/dubbing/video-translate, если нужен MP4 с переведённой речью поверх исходного изображения. Для видео с изменением движений губ рассмотрите HeyGen Video Translate; Video Translator V1 — другой вариант перевода видео. Используйте собственные записи или согласие говорящих и не выдавайте результат за речь реального человека.
Быстрый старт 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/audio-to-audio",
"input": {
"audio_url": "https://example.com/reference.mp3",
"source_language": "auto",
"target_language": "en"
}
}'
# 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.




