Введение
Что делает этот эндпоинт
VEED Dubbing распознаёт речь в video_url, переводит её на target_language, озвучивает клонированным голосом каждого участника и перерисовывает область рта под новые слова. Остальная часть каждого кадра сохраняется.
Важные входные параметры
target_language — один из 86 базовых языков. Значение source_language по умолчанию — auto; задавайте его только при ошибке определения языка. keyterms принимает до десяти имён, названий или коротких фраз, которые распознавание речи должно записать точно в указанном виде.
Что вы получите
Один MP4 с исходным размером кадра и частотой 25 fps, примерно той же длительности, что и исходник. В наших тестах четырёхсекундный ролик был готов примерно за 80 секунд, а восьмисекундный диалог двух человек — примерно за четыре минуты.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Обязательные данные | Видео с речью (загрузка или прямая ссылка на файл) и целевой язык |
| Длина ролика | До 10 минут |
| Языков дубляжа | 86 базовых языков |
| Язык речи | Определяется автоматически или выбирается из 86 языков |
| Голоса | Голос каждого участника клонируется из ролика |
| Результат | MP4 с исходным размером кадра, 25 fps, синхронизированные губы |
| Оплата | За секунду исходного ролика с округлением вверх |
Ключевые возможности и особенности
Сцена с двумя героями: дубляж на испанский с перерисовкой рта
Наш восьмисекундный диалог в винном погребе вернулся на испанском: движения губ обоих героев были синхронизированы с новыми репликами. Перерисовывается только область вокруг рта каждого героя. Бочки, бокал и освещение покадрово совпадают с оригиналом.
Тот же кадр, другая форма рта
Один и тот же момент рядом: слева — исходная съёмка на английском, справа — дубляж на испанский. Теперь рот мужчины произносит испанскую реплику, а остальная часть лица, борода и фон остаются такими, какими были при съёмке.
Голос каждого героя клонируется из самого клипа
Ничего не нужно включать или загружать отдельную аудиозапись для образца. Каждый голос в дубляже создаётся из собственных реплик говорящего. Поэтому у двух героев сохраняются два разных тембра и на новом языке.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Ролик для дубляжа длительностью до 10 минут с речью на звуковой дорожке. Не менее 1 символов |
target_language | Да | Обязательно. Один из 86 базовых языков дубляжа. |
source_language | Нет | Язык речи в ролике. По умолчанию auto — автоматическое определение. |
keyterms | Нет | До 10 имён, названий или коротких фраз для точной транскрипции, до 50 символов и 5 слов в каждом, без < > { } [ ] и обратных косых черт. Не более 10 элементов |
Стоимость
$0.144 / секунда результата
Оплата за секунду исходного ролика с округлением вверх до целой секунды, не более 10 минут. Предварительная оценка использует длительность загруженного ролика, а для ссылки — максимум в 10 минут. Разница освобождается при окончательном расчёте задачи. Выбор языка и keyterms не влияют на цену. Неудачные запросы не оплачиваются.
Сценарии использования
Ролики с обращением к зрителю для новых рынков
Автор может опубликовать одну и ту же запись на испанском, немецком или японском, а зрители увидят движения губ под новые слова.
Реклама и ролики о продуктах
Локализуйте короткие ролики с ведущим без пересъёмки и актёра дубляжа. Стоимость зависит от длительности видео в секундах.
Персонажи из видеомоделей
Сгенерированного англоязычного персонажа можно озвучить на другом языке и синхронизировать губы, чтобы сцена выглядела естественно.
Руководство по промптам и практические советы
Отправьте ролик с чёткой речью
Загрузите видео или укажите прямую ссылку на файл. Лучше всего движения рта получаются на хорошо освещённых лицах, обращённых к камере.
Выберите язык дубляжа
Выберите
target_languageиз 86 базовых языков. Оставьтеsource_languageв значении auto, если распознавание не ошибается с языком регулярно.Укажите важные имена и названия
Добавьте до десяти keyterms, например название бренда или имя персонажа, чтобы распознавание речи использовало ваше написание.
Введение
VEED Dubbing — стандартный вариант API дубляжа VEED. Отправьте ролик с речью в video_url, выберите target_language и получите видео на этом языке с клонированным голосом каждого участника и движениями губ под перевод.
Возможности и преимущества
Губы следуют за новым языком
Область рта перерисовывается у каждого видимого говорящего. В нашем тесте в винном погребе губы и женщины, и мужчины были синхронизированы с испанской речью, а бочки, бокал и освещение остались без изменений.
Узнаваемые голоса
Ничего включать не нужно: голос каждого участника клонируется из самого ролика. Дубляж сохраняет тембр без отдельного образца голоса.
Перевод с сохранением смысла
В нашем тесте женщина говорила, что её привели в погреб одну. Перевод использовал «a solas», избежав ошибки в грамматическом роде, возможной при дословном переводе.
Сценарии использования
Один автор, несколько языков
Запишите один раз и публикуйте ролик для каждого рынка с движениями губ под соответствующую версию.
Локализация сгенерированных сцен
Дублируйте персонажей видеомодели на язык аудитории, сохраняя убедительные движения рта.
Советы по входным данным
Лица должны быть видны
Хорошо освещённые лица, обращённые к камере, дают наиболее чёткую синхронизацию губ. На общих планах и при закрытых лицах новый звук тоже будет, но видимых изменений вокруг рта будет мало.
Используйте keyterms для имён, а не переводов
Keyterms помогают транскрипции распознать имя или бренд; это не пары «термин — перевод». Пишите каждый термин так, как он произносится в ролике.
Нужен акцент?
Этот вариант предлагает дубляж на базовые языки. Региональные акценты и настройка сходства голоса доступны в VEED Dubbing Pro.
Быстрый старт 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": "veed/dubbing/video-translate",
"input": {
"source_language": "auto",
"target_language": "af",
"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.
