Введение
Video Translator дублирует клип с речью на другой язык. Отправьте запись в video_url и выберите target_language: инструмент расшифровывает речь, переводит её, озвучивает заново в такт исходным репликам и возвращает ту же картинку с новым звуком. Включите clone_voice, и каждый говорящий сохранит голос, смоделированный по его собственному.
Ключевые возможности и особенности
Говорящие остаются собой
При включённом clone_voice дубляж звучит голосом, собранным по голосу каждого говорящего: в нашем тесте с двумя участниками женщина и мужчина вернулись на испанском со своим тембром, а каждая реплика начиналась там же, где начиналась исходная.
Оставьте музыку или уберите её
keep_background_audio решает, что звучит под дубляжом. Если оставить его включённым, атмосфера подвала и комнатный шум остаются на своих местах. Если выключить, в возвращённом клипе будут только переведённые голоса с настоящей тишиной между репликами, готовые для вашего микса.
Ваши имена остаются вашими
Перечислите термины в glossary парами {term, translation} — и они каждый раз будут переводиться так, как вы задали. В нашем тесте фраза из глоссария использовалась дословно в обеих репликах, где встречалась.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип для перевода, от 1 секунды до 10 минут. Картинка возвращается без изменений. Не менее 1 символов |
target_language | Нет | Язык дубляжа, один из 28. По умолчанию английский. |
source_language | Нет | Язык речи в клипе. По умолчанию auto, то есть определяется автоматически. |
clone_voice | Нет | По умолчанию выключено. Включено: каждый говорящий озвучивается голосом, смоделированным по его собственному. По умолчанию: |
keep_background_audio | Нет | Включено по умолчанию: музыка и звуковые эффекты остаются под дубляжом. Выключено: возвращаются только переведённые голоса, с тишиной между репликами. По умолчанию: |
speaker_count | Нет | Сколько людей говорит в клипе, от 1 до 4. Не указывайте, чтобы инструмент посчитал сам. |
glossary | Нет | Имена, бренды и фразы с фиксированным переводом парами «термин / перевод», до 100. Используйте, чтобы имя не переводилось вовсе: укажите одинаковый текст с обеих сторон. Не более 100 элементов |
Стоимость
$0.005 / секунда результата
Оплата целыми минутами исходного клипа, поэтому клип в 70 секунд стоит столько же, сколько 2 минуты. Клип должен длиться от 1 секунды до 10 минут; оценка до отправки использует реальную длину загруженного клипа или максимум 10 минут для ссылки на видео, а разница возвращается по завершении задачи. Опции вроде клонирования голоса или удаления фона цену не меняют.
Сценарии использования
Локализация коротких видео
Публикуйте тот же клип для нескольких языковых рынков, не нанимая актёра озвучивания под каждый. Клипы короче минуты стоят одну минуту.
Озвучивание персонажей из видеомоделей
Сгенерированные персонажи, которые говорят по-английски, можно озвучить на языке вашей аудитории, сохранив голос персонажа.
Руководство по промптам и практические советы
Задавайте язык речи, если есть музыка
Автоопределение надёжно на чистой речи. На клипе с гитарой под шёпотом по-французски оно сдалось, и задача завершилась ошибкой с возвратом; тот же клип с source_language, заданным как французский, прошёл. Если задача падает с сообщением об обработке видео, задайте source_language и отправьте снова.
Укажите, сколько людей говорят
speaker_count необязателен, но при диалоге двух людей его указание сохраняет каждую реплику за нужным голосом.
Учитывайте картинку
Заменяется только звук. Для крупных планов, где важен рот, пропустите дублированный клип через инструмент Lip Sync.
Быстрый старт 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": "spicyapi/video-translator-v1/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.
