Skip to main content
Obter status da tradução

Obter status da tradução

Recupere o status atual de um projeto de tradução. Use este endpoint para verificar o progresso e obter a URL do vídeo traduzido quando o processamento estiver concluído.

Solicitação

Cabeçalhos

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

Parâmetros de caminho

string
obrigatório
O identificador exclusivo do projeto de tradução retornado pelo endpoint Iniciar tradução.

Resposta

A estrutura da resposta varia de acordo com o status da tradução.

Campos comuns

string
obrigatório
O identificador exclusivo do projeto
string
obrigatório
O nome do projeto
string
obrigatório
URL para o arquivo de vídeo/áudio original enviado
string
obrigatório
O idioma original detectado ou especificado
string
obrigatório
O idioma de destino para a tradução
number
obrigatório
Duração do conteúdo em segundos
number
obrigatório
Timestamp Unix de quando o projeto foi criado
string
obrigatório
Fluxo de trabalho da API que criou o projeto: translation ou transcription.
string
obrigatório
Status da transcrição de origem: processing, success ou failed. Este sinal é independente da conclusão da dublagem.
object
obrigatório
Transcrições normalizadas disponíveis.
string
Identificador de trabalho de tradução para a versão traduzida relatada atualmente.
string
Identificador da versão traduzida para a versão traduzida relatada atualmente.
string
Etapa atual do projeto. Durante a criação ou transcrição, isso reflete a etapa de criação ativa. Exemplos incluem downloading_content, content_validation e transcription_processing. Assim que a dublagem começa, ela pode mudar para uma etapa de dublagem ativa, como smart_sync ou audio_assembling. status: processing não faz par com actualProgressStep: done.
number
Porcentagem de progresso aproximada para a criação/transcrição do projeto (0-100)
string
Etapa atual de dublagem para o idioma de destino (por exemplo, smart_sync, audio_enhancement, video_upload)
number
Porcentagem de progresso aproximada para a dublagem (0-100)
string
obrigatório
Status atual da tradução: processing, success ou failed

Campos de Lip Sync

Quando a sincronização labial foi solicitada, a resposta inclui um objeto lipSync adicional:
object
Status da sincronização labial e detalhes de saída (presente apenas quando a sincronização labial foi solicitada)
Quando a sincronização labial é solicitada, a tradução permanece em processing até que lipSync.status seja COMPLETED. Se a sincronização labial falhar, o status torna-se failed e o error.code é LIPSYNC_FAILED. Quando a sincronização labial é bem-sucedida, leia o ativo sincronizado labialmente de lipSync.videoUrl; translatedVideoUrl é a saída de vídeo traduzida antes da sobreposição de sincronização labial.
Use GET /v1/projects/{projectId} quando precisar do histórico completo da versão traduzida ou do histórico completo de sincronização labial.

Campos de resposta de sucesso

Para fluxos de trabalho de tradução, os seguintes campos são incluídos quando status é success. Um fluxo de trabalho apenas de transcrição atinge success sem campos de mídia traduzidos.
string
URL para baixar o arquivo de vídeo traduzido
string
URL para baixar o arquivo de áudio traduzido separadamente

Campos de resposta de falha

Quando status é failed, o seguinte campo adicional é incluído:
object
Detalhes do erro

Exemplos

Exemplos de resposta

Status de processamento

Status de processamento (Lip Sync solicitado)

Status de sucesso

Status de sucesso (Lip Sync concluído)

Status de falha

Melhores práticas de sondagem

Intervalo de sondagem recomendado: 10-30 segundosO tempo de tradução varia de acordo com a duração e a complexidade do vídeo. Para um vídeo típico de 2 minutos, espere de 2 a 5 minutos de tempo de processamento.
Limite de taxa: 30 solicitações por minutoEvite sondar com frequência superior a uma vez a cada 2 segundos para permanecer dentro dos limites de taxa.

Erros