Skip to main content
Iniciar Tradução

Iniciar Tradução

Crie um novo projeto de tradução enviando um arquivo de vídeo ou áudio. O processo de tradução é executado de forma assíncrona em segundo plano. Use o endpoint de status para acompanhar o progresso e recuperar resultados. Use Obter Detalhes do Projeto quando precisar do histórico da versão traduzida ou do histórico de sincronização labial.

Limite de Simultaneidade

A criação de projetos, a tradução e a dublagem verificam o limite de traduções ativas da sua conta (no máximo 10, possivelmente menos). Apenas traduções ou dublagens em andamento ocupam vagas; projetos apenas de transcrição não ocupam. Ao atingir o limite, a API retorna CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429). O limite aplicado aparece em details.limit.

Solicitação

Este endpoint aceita multipart/form-data com um upload de arquivo.

Cabeçalhos

string
obrigatório
Sua chave de API VoiceCheap. Obtenha uma em app.voicecheap.ai/page-api.

Parâmetros do corpo

file
obrigatório
O arquivo de vídeo ou áudio a ser traduzido.Formatos de vídeo suportados: video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpegFormatos de áudio suportados: audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webmTamanho máximo de arquivo por plano: Beginner 5 GB, Starter 10 GB, Creator 20 GB, Pro 30 GB, Scale 40 GB e Enterprise 60 GB.
string
obrigatório
O idioma para o qual o conteúdo será traduzido. Deve estar em letras minúsculas.Valores permitidos (70+): afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, pt_brazil, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
O idioma de origem do conteúdo usando códigos de idioma ISO (por exemplo, en, es, fr, de, ja, zh).
Altamente recomendado: Deixe este campo vazio para detecção automática.Forneça este parâmetro apenas se tiver 100% de certeza de que o código do idioma está correto e no formato ISO válido. Códigos de idioma incorretos causarão falhas na transcrição. Nossa detecção automática suporta mais de 80 idiomas e é altamente precisa.
Padrão: auto-detect
string
Um nome personalizado para o projeto. Útil para identificar projetos em seu painel.Padrão: O ID do projeto será usado se não for fornecido.
string
Um endpoint https que recebe a eventos de webhook para este projeto, substituindo o endpoint configurado em sua conta.Padrão: O endpoint de webhook da conta, quando um estiver configurado.
string
auto-detect ou um número inteiro de 1 a 32. Uma contagem de falantes conhecida pode melhorar a diarização.Padrão: auto-detect
string
Uma matriz de strings JSON de nomes, marcas, siglas ou termos especializados específicos da solicitação. Esses termos são mesclados com o glossário salvo da conta ou da equipe.
boolean
Remova palavras de preenchimento comuns da transcrição de origem antes da tradução.Padrão: true
string
Uma transcrição SRT existente no idioma de origem. originalLanguage deve ser explícito quando este campo for fornecido.
string
O SRT final no idioma de destino, escrito por você. Quando informado, a VoiceCheap ignora o motor de tradução e apenas gera as vozes e mistura a saída a partir deste texto. Veja o modo só de dublagem para as regras de alinhamento. Máximo de 1.000.000 de caracteres.
boolean
Se deve preservar o áudio de fundo na saída.Quando ativado, mantém música de fundo, ambiente, risadas, aplausos e sons de multidão, removendo apenas a voz original (separação de stems). Desative se sua fonte não tiver áudio de fundo.Padrão: true
boolean
Mantenha o falante original em volume baixo sob a voz traduzida.Padrão: false
number
Volume da voz original de 1 a 70 quando keepOriginalVoice estiver ativado.Padrão: 30
string
Modo de isolamento de voz quando keepBackgroundMusic estiver ativado. Controla a qualidade e as características da separação de voz.
Nosso processamento de voz padrão, projetado para qualidade de áudio profissional:
  • Remove ecos e reverberações
  • Limpa imperfeições técnicas
  • Produz uma voz clara e nítida
Recomendado para: A maioria dos projetos onde a qualidade do áudio é fundamental. Ideal para tutoriais, conteúdo educacional, vídeos de marketing e qualquer conteúdo que exija clareza de voz ideal.
Preserva as características naturais do ambiente de gravação:
  • Mantém um som mais próximo da gravação original
  • Preserva as características ambientais
Recomendado para: Conteúdo onde a autenticidade do ambiente é importante, como vlogs ao ar livre, documentários ou conteúdo onde o ambiente sonoro seja parte integrante da experiência.
Esta opção pode criar artefatos ou efeitos inesperados em alguns casos devido à preservação de elementos de fundo.
Valores permitidos: studio, realisticPadrão: studio
boolean
Se deve gerar legendas para o vídeo traduzido.Quando ativado, adiciona legendas legíveis em preto e branco. Use subtitlesSource para escolher o texto original (idioma de origem) ou traduzido (idioma de destino). As legendas são sincronizadas automaticamente para facilitar a leitura.Padrão: false
string
Escolha a fonte do texto das legendas quando subtitles estiver ativado.Valores permitidos: translated, originalPadrão: translatedNota: Se original for selecionado, mas a transcrição original não estiver disponível, as legendas usarão translated como alternativa.
string
Aciona o processamento de sincronização labial após a conclusão da dublagem.
  • standard = Lip Sync
  • pro = Lip Sync Pro
  • studio = Lip Sync Studio
Os modos premium aplicam seus requisitos normais de plano, duração e créditos.Padrão: omita o campo para ignorar a sincronização labial.
boolean
Ativa a detecção de orador ativo para a execução de sincronização labial solicitada.Padrão: false
boolean
Seletor de sincronização labial legado mantido para compatibilidade com versões anteriores.
  • false = Sincronização labial padrão (4 minutos de créditos por 1 minuto de vídeo)
  • true = Lip Sync Pro (9 minutos de créditos por 1 minuto de vídeo)
Lip Sync Pro está disponível a partir do plano Creator.
Duração máxima: 180 minutos por vídeo.Latência: O processamento de sincronização labial normalmente adiciona 2x-4x a duração do vídeo original.
E-mails de conclusão e falha de sincronização labial não são enviados para solicitações acionadas por API. Use o status endpoint para acompanhar o progresso.
Padrão: não ativado (omita o campo para ignorar a sincronização labial)Form-data: Envie valores booleanos como strings true ou false (por exemplo, -F "lipsyncPro=false").
Não combine lipsyncPro com um lipSyncMode conflitante.
string
Estratégia de voz: cloning ou custom.Padrão: cloning
string
Obrigatório quando voiceMode é custom. Use um ID de dubbing_voices_list: uma voz do catálogo ou uma voz personalizada salva pela conta autenticada. A cobrança da equipe não concede acesso às vozes salvas de outros membros.
object
Ajuste os parâmetros de clonagem de voz para controle avançado sobre a voz gerada. Passe como uma string JSON ao usar form-data. Todos os valores devem estar entre 0 e 1 (com incremento de 0,01). Um valor speakerBoost enviado por integrações anteriores ainda é aceito, mas não tem mais nenhum efeito.
Estas configurações aplicam-se apenas quando voiceMode é cloning.
Valores padrão (equilibrados):
string
Uma matriz JSON de intervalos de tempo de origem que devem permanecer no idioma original.
Pulos de tempo exigem entrada de vídeo e keepBackgroundMusic=true. Eles não podem ser combinados com keepOriginalVoice e não podem sobrepor segmentos de transcrição.

Modo só de dublagem (traga a sua tradução)

Envie translatedSrt quando a tradução já existir e a VoiceCheap só precisar gerar as vozes e mixar a saída. Neste modo:
  • Sem tradução por IA e sem reformulação SmartSync. Cada cue é falado literalmente. Regras de glossário salvas e instruções de tradução personalizadas também não se aplicam, porque só são executadas no motor de tradução.
  • O tempo vem da fonte. Cada segmento mantém o início, o fim e o locutor da transcrição de origem; os timecodes do seu SRT servem apenas para associar cues a segmentos. A fala gerada é esticada ou comprimida para caber na janela do segmento, sem reformular o texto.
  • Os mesmos créditos de uma tradução. A execução é cobrada exatamente como uma tradução padrão da mesma mídia.
  • As opções de voz, fundo, legendas e sincronização labial continuam valendo. voiceMode, keepBackgroundMusic, subtitles, lipSyncMode e as outras opções de dublagem se comportam como documentado acima.
O message da resposta confirma o modo, e a versão traduzida informa dubbingMode: "dub-only" em Obter Detalhes do Projeto.

Regras de alinhamento

Os problemas de alinhamento no modo timestamps só são conhecidos após a transcrição e são reportados de forma assíncrona. O endpoint de status devolve HTTP 200 com status: "failed" e um error com code e message; o webhook project.translation.failed inclui o mesmo código e mensagem. Em TRANSLATED_SRT_UNMATCHED_CUES, os números dos cues sem correspondência aparecem na mensagem; em TRANSLATED_SRT_MISSING_SEGMENTS, aparecem os índices dos segmentos sem cue. Estas respostas não incluem um campo details estruturado. Para um mapeamento determinístico, envie sourceSrt com translatedSrt ou crie primeiro o projeto com Criar projeto, exporte a transcrição, traduza-a cue a cue e chame Dublar o projeto.

Verificar o ritmo

Frases longas precisam ser aceleradas para caber no segmento. Exporte a transcrição traduzida com Exportar transcrição do projeto: cada segmento traduzido traz finalSpeedFactor, a razão entre a fala gerada e a janela do segmento antes do ajuste final de tempo. Encurte os cues que ficarem acima de cerca de 1.3 e execute a dublagem de novo com o SRT revisado.
translatedSrt também é aceito no endpoint JSON Dublar o projeto, que dubla um projeto já transcrito sem enviar a mídia outra vez.

Resposta

boolean
obrigatório
Sempre true para solicitações bem-sucedidas
string
obrigatório
Uma mensagem legível por humanos descrevendo o resultado
string
obrigatório
O identificador único para o projeto de tradução criado. Use este ID para verificar o status.
number
obrigatório
Estimativa aproximada de processamento em minutos. A estimativa atual é de cinco minutos de processamento por minuto iniciado de mídia de origem.

Exemplos

Regras de glossário salvas e instruções de tradução personalizadas da conta ou equipe efetiva são aplicadas automaticamente.

Exemplo de Resposta

Erros