Introdução
O Video Translator dubla um clipe com fala para outro idioma. Envie a filmagem em video_url e escolha target_language; a ferramenta transcreve a fala, traduz, regrava no tempo das falas originais e devolve a mesma imagem com o novo áudio. Ative clone_voice e cada falante mantém uma voz modelada na sua.
Recursos e destaques
Os falantes continuam soando como eles mesmos
Com clone_voice ligado, a dublagem é falada com uma voz construída a partir da voz de cada falante: no nosso teste com duas pessoas, a mulher e o homem voltaram em espanhol com o próprio timbre, e cada fala começou onde a fala original começava.
Mantenha a trilha ou remova
keep_background_audio decide o que fica por baixo da dublagem. Ligado, o ambiente da adega e a sonoridade da sala continuam exatamente onde estavam. Desligado, o clipe devolvido traz só as vozes traduzidas, com silêncio entre as falas, pronto para a sua mixagem.
Seus nomes continuam sendo seus
Liste termos em glossary como pares {term, translation} e eles serão traduzidos do seu jeito sempre. No nosso teste, uma frase listada no glossário foi usada textualmente nas duas falas em que aparecia.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe a traduzir, de 1 segundo a 10 minutos. A imagem volta sem alteração. pelo menos 1 caracteres |
target_language | Não | O idioma para dublar, um dos 28. Padrão inglês. |
source_language | Não | O idioma falado no clipe. Padrão auto, que o detecta. |
clone_voice | Não | Desligado por padrão. Ligado: cada falante é regravado com uma voz modelada na dele. Valor padrão: |
keep_background_audio | Não | Ligado por padrão: a música e os efeitos sonoros continuam por baixo da dublagem. Desligado: só as vozes traduzidas são devolvidas, com silêncio entre as falas. Valor padrão: |
speaker_count | Não | Quantas pessoas falam no clipe, de 1 a 4. Deixe de fora para que a ferramenta as conte. |
glossary | Não | Nomes, marcas e frases com tradução fixa, como pares termo / tradução, até 100. Use para nomes que não devem ser traduzidos, repetindo o mesmo texto dos dois lados. no máximo 100 itens |
Preços
$0.005 / segundo de saída
Cobrado em minutos inteiros do clipe de origem, então um clipe de 70 segundos custa o mesmo que 2 minutos. O clipe precisa ter de 1 segundo a 10 minutos; a estimativa antes do envio usa a duração real de um clipe que você enviou, ou o máximo de 10 minutos para uma URL de vídeo, e a diferença é liberada quando a tarefa é concluída. Opções como vozes clonadas ou remoção do fundo não mudam o preço.
Casos de uso
Localizar vídeos curtos
Publique o mesmo clipe para vários mercados de idioma sem contratar um dublador para cada um. Clipes de menos de um minuto custam um minuto.
Dublar personagens de modelos de vídeo
Personagens gerados que falam inglês podem ser dublados no idioma do seu público mantendo a voz do personagem.
Guia de prompt e dicas práticas
Defina o idioma falado quando houver música
A detecção automática é confiável em fala limpa. Em um clipe com violão sob uma fala sussurrada em francês, ela desistiu e a tarefa falhou (com a cobrança devolvida); o mesmo clipe com source_language definido como francês foi concluído. Se uma tarefa falhar com uma mensagem sobre o processamento do vídeo, defina source_language e envie de novo.
Diga quantas pessoas falam
speaker_count é opcional, mas defini-lo num diálogo de duas pessoas mantém cada fala com a voz certa.
Planeje para a imagem
Só o áudio é trocado. Para closes em que a boca importa, passe o clipe dublado pela ferramenta Lip Sync depois.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
