Entradas
Mídia e idiomas
Fontes de texto de legenda
Use estes campos se tiver texto de legendas original ou traduzido para fornecer. Caso contrário, pode ignorar esta secção.Tradução e dublagem
Use estes campos para personalizar modelos, definições ou requisitos de tradução e dublagem. Caso contrário, pode ignorar esta secção.| Campo | Valores | Requisito | Descrição |
|---|---|---|---|
speaker_number | { min, max } | Opcional | Especifica o intervalo esperado de número de locutores. min deve ser pelo menos 1 e max não pode exceder 35. Omita este campo para detecção automática. |
voice_model | auto, real, native | Opcional | Seleciona o modelo de clonagem de voz usado para dublagem. O padrão é auto: auto seleciona automaticamente o melhor modelo para o seu conteúdo; real usa VoiceREAL para preservar a emoção e o sotaque da voz original; native usa VoiceNATIVE para oferecer um sotaque mais natural no idioma de destino. |
selected_voice_id | String | Opcional | Usa uma voz específica da Biblioteca de Vozes no aplicativo web da Vozo para dublagem. Quando este campo é fornecido, ele substitui voice_model: a API ignora a clonagem automática de voz e usa a voz selecionada para gerar o áudio dublado. |
align_video | Boolean | Opcional; apenas vídeo | Quando definido como true, ajusta automaticamente a velocidade do vídeo para que o áudio traduzido e o vídeo permaneçam sincronizados durante todo o conteúdo. O padrão é false. Defina como false se o áudio traduzido for usado como uma faixa de áudio adicional no YouTube. |
glossary_ids | Array de até 3 IDs | Opcional | Aplica glossários criados no aplicativo web da Vozo para manter a terminologia consistente.  |
user_prompt | String | Opcional | Fornece instruções de tradução ou dublagem, como preferências de tom, estilo ou terminologia. |
Saída de legendas
Use estes campos se quiser adicionar legendas traduzidas ao vídeo ou apagar e substituir as legendas existentes. Caso contrário, pode ignorar esta secção.| Campo | Valores | Requisito | Descrição |
|---|---|---|---|
subtitle_mode | none, add, replace | Opcional | Controla a renderização das legendas: não renderizar legendas, adicionar legendas traduzidas ou apagar as legendas existentes antes de renderizar as legendas traduzidas. O padrão é none. |
subtitle_style_id | String | Opcional; aplica-se com add ou replace | Aplica um estilo de legenda copiado de um projeto no aplicativo web da Vozo. Se omitido, será usado o estilo de legenda padrão integrado.  |
subtitle_position_y | Número de 0 a 1 | Opcional; aplica-se com add ou replace | Define a posição vertical da legenda, do topo (0) até a parte inferior (1). Por exemplo, 0,75 posiciona as legendas em 75% da altura do vídeo. Consulte as regras de posicionamento abaixo. Quando enable_proofreading for true e subtitle_mode for replace, este campo não terá efeito. |
Se
subtitle_style_id for omitido, será usado o estilo padrão integrado. Ele exibe uma única linha centralizada usando texto branco Noto Sans Medium no tamanho de fonte 14, com contorno externo preto e uma sombra preta sutil. A largura da legenda é 80% do vídeo, sem fundo, efeito de palavra ativa ou transição.Se subtitle_position_y for omitido, seu valor não virá do estilo de legenda selecionado. A posição é determinada por subtitle_mode:- Para
add, o padrão é0,9para vídeos horizontais e quadrados, e0,75para vídeos verticais. - Para
replace, as legendas são posicionadas na posição original da legenda.
enable_proofreading for true e subtitle_mode for replace, a posição da legenda permanecerá na região onde as legendas originais foram apagadas após a dublagem ser concluída no projeto. Qualquer valor especificado em subtitle_position_y será ignorado.Projeto e saída
Saídas
(dependendo deexport_type, project_mode e enable_proofreading):
- URL de vídeo e/ou áudio traduzido
subtitle_urltraduzida (SRT)project_urlquando um projeto é criado no Painel de Controle web
Como funciona
1
Hospede seus recursos em uma URL acessível publicamente
Envie seu vídeo ou áudio, junto com quaisquer recursos opcionais, para que nossos servidores possam recuperá-los.
2
Envie uma solicitação de API
Forneça as entradas obrigatórias e quaisquer configurações opcionais necessárias para a tarefa.
3
Aguarde ou consulte o status
Use nosso callback de webhook ou consulte a API com o ID da sua tarefa até que o processamento seja concluído.
4
Baixe as saídas
Recupere o vídeo/áudio traduzido e a legenda traduzida (.srt) a partir das URLs fornecidas.
Limitações de uso
- Somente usuários que podem criar chaves de API podem usar esta API.
- O plano Studio é obrigatório; usuários que não são do Studio não têm permissão.
- O limite de simultaneidade padrão é de 10 tarefas. O limite é compartilhado por todos os membros de uma equipe. Consulte Limites de simultaneidade para mais detalhes.
- O código de idioma segue o padrão IETF BCP 47, por exemplo, en‑US.