Vozo Help Center

A API de Tradução Visual localiza o Texto na tela em vídeos, preservando seu layout, estilo e animações. Use-a para automatizar a tradução de texto visual em apresentações, demonstrações de produtos, vídeos de marketing e outros vídeos com texto incorporado. A API retorna um vídeo traduzido e pode, opcionalmente, criar um projeto editável no aplicativo web da Vozo.

Entradas

Campo	Valores	Requisito	Descrição
`video_url`	URL de vídeo acessível publicamente	Obrigatório	URL do vídeo de entrada. A duração máxima suportada é de 20 minutos.
`source_language`	Código de idioma suportado	Obrigatório	Idioma de origem do Texto na tela. A detecção automática não é suportada.
`target_language`	Código de idioma suportado, com localidade opcional	Obrigatório	Idioma de destino do Texto na tela traduzido.
`glossary_ids`	Matriz 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 para o estilo da Tradução Visual.
`project_mode`	`none`, `editable`	Opcional	Controla se um projeto editável de Tradução Visual é criado no aplicativo web da Vozo. O padrão é `none`.
`callback_url`	URL	Opcional	Recebe um webhook sempre que o status da tarefa muda.

Saídas

video_url traduzido
project_url quando project_mode é editable

Como funciona

Hospede seu vídeo em uma URL acessível publicamente

Envie o vídeo de entrada para que nossos servidores possam acessá-lo. O vídeo deve ter no máximo 20 minutos.

Envie uma solicitação de Tradução Visual

Forneça as entradas obrigatórias e as configurações opcionais necessárias para a tarefa.

Aguarde ou consulte o status

Use o webhook de callback ou consulte a API com o ID da tarefa retornado até que o processamento seja concluído.

Baixe o vídeo traduzido

Quando a tarefa for concluída, obtenha o vídeo traduzido na URL fornecida. Se você criou um projeto editável, abra a URL do projeto para revisá-lo ou editá-lo no Painel de Controle.

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 sejam Studio não são permitidos.
O limite de simultaneidade padrão é de 10 tarefas. Esse limite é compartilhado por todos os membros de uma equipe. Consulte Limites de simultaneidade para obter detalhes.
A entrada deve ser um arquivo de vídeo. A exportação somente de áudio não é suportada.
A duração máxima de entrada suportada é de 20 minutos.
A detecção automática do idioma de origem não é suportada. Forneça explicitamente um código de idioma de origem suportado.
O código de idioma segue o padrão IETF BCP 47, por exemplo, en-US, zh-CN, zh-CN-GUANGXI.

Códigos de erro da API

Código	Descrição
5	Parâmetros de solicitação inválidos.
7	Sem permissão para solicitar.
104	Créditos insuficientes.
814	Sua conta não é membro e não tem permissão para chamar a API.
1000	Erro interno do servidor.
1301	A verificação de desafio do callback falhou.
1302	A chave de API foi revogada.
1304	A chave de API atingiu o número máximo de solicitações simultâneas.
1503	Sua conta não está autorizada a chamar a API.
1305	Somente o Plano Studio é permitido.

Códigos de erro da tarefa

Código	Descrição
40002	O arquivo enviado não possui fluxo de vídeo.
40010	A transcodificação falhou.
40050	A tradução falhou.
40020	A extração de OCR falhou.
40032	Não há callouts válidos no vídeo.
40040	A correspondência entre OCR e callouts falhou.
40041	Falha ao corresponder qualquer callout ao OCR.
40060	Falha ao refinar os callouts.
40061	Falha ao extrair o estilo no refinamento.
40080	A geração do vídeo de pré-visualização falhou.

Idiomas suportados

Idiomas de origem

A detecção automática não é suportada. Informe um dos seguintes códigos de idioma:

Código	Nome
sq-AL	Albanês
az-AZ	Azerbaijano
eu-ES	Basco
bs-BA	Bósnio
ca-ES	Catalão
zh-CN	Chinês (Simplificado)
zh-TW	Chinês (Tradicional)
hr-HR	Croata
cs-CZ	Tcheco
da-DK	Dinamarquês
nl-NL	Neerlandês
en-US	Inglês
et-EE	Estoniano
fi-FI	Finlandês
fr-FR	Francês
gl-ES	Galego
de-DE	Alemão
hi-IN	Hindi
hu-HU	Húngaro
is-IS	Islandês
id-ID	Indonésio
ga-IE	Irlandês
it-IT	Italiano
ja-JP	Japonês
ko-KR	Coreano
lv-LV	Letão
lt-LT	Lituano
ms-MY	Malaio
mt-MT	Maltês
nb-NO	Norueguês
fa-IR	Persa
pl-PL	Polonês
pt-PT	Português
ro-RO	Romeno
ru-RU	Russo
sr-RS	Sérvio
sk-SK	Eslovaco
sl-SI	Esloveno
es-ES	Espanhol
sw-KE	Suaíli
sv-SE	Sueco
fil-PH	Filipino
tr-TR	Turco
uz-UZ	Uzbeque
vi-VN	Vietnamita

Idiomas de destino

Código	Nome	Variantes de localidade
en	Inglês	en‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ
zh	Chinês	zh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI
wuu	Chinês Wu	wuu‑CN
es	Espanhol	es‑ES, es‑MX, es‑US, es‑AR, es‑BO, es‑CL, es‑CO, es‑CR, es‑CU, es‑DO, es‑EC, es‑SV, es‑GQ, es‑GT, es‑HN, es‑NI, es‑PA, es‑PY, es‑PE, es‑PR, es‑UY, es‑VE
ar	Árabe	ar‑DZ, ar‑BH, ar‑IQ, ar‑JO, ar‑KW, ar‑LB, ar‑LY, ar‑MA, ar‑OM, ar‑QA, ar‑SY, ar‑TN, ar‑AE, ar‑YE
ru	Russo	ru‑RU
pt	Português	pt‑PT, pt‑BR
fr	Francês	fr‑FR, fr‑CA, fr‑BE, fr‑CH
de	Alemão	de‑DE, de‑AT, de‑CH
ko	Coreano	ko‑KR
ja	Japonês	ja‑JP
hi	Hindi	hi‑IN
tr	Turco	tr‑TR
fil	Filipino	fil‑PH
fi	Finlandês	fi‑FI
cs	Tcheco	cs‑CZ
da	Dinamarquês	da‑DK
nl	Neerlandês	nl‑BE
pl	Polonês	pl‑PL
ro	Romeno	ro‑RO
sk	Eslovaco	sk‑SK
sv	Sueco	sv‑SE
hr	Croata	hr‑HR
id	Indonésio	id‑ID
it	Italiano	it‑IT, it‑CH
bg	Búlgaro	bg‑BG
el	Grego	el‑GR
ms	Malaio	ms‑MY
ta	Tâmil	ta‑IN, ta‑MY, ta‑SG, ta‑LK
uk	Ucraniano	uk‑UA
th	Tailandês	th‑TH
vi	Vietnamita	vi‑VN
am	Amárico	am‑ET
bn	Bengali	bn‑IN, bn‑BD
as	Assamês	as
bs	Bósnio	bs‑BA
ca	Catalão	ca‑ES
et	Estoniano	et‑EE
eu	Basco	eu‑ES
gl	Galego	gl‑ES
gu	Guzerate	gu
he	Hebraico	he‑IL
hu	Húngaro	hu‑HU
iu	Inuktitut	iu‑CANS‑CA, iu‑LATN‑CA
jv	Javanês	jv‑ID
mk	Macedônio	mk‑MK
mr	Marata	mr
nb	Norueguês Bokmål	nb‑NO
ne	Nepalês	ne‑NP
or	Oriá	or
pa	Punjabi	pa
ps	Pachto	ps‑AF
sl	Esloveno	sl‑SI
sw	Suaíli	sw‑KE, sw‑TZ
te	Télugo	te‑IN
ur	Urdu	ur, ur‑IN, ur‑PK
zu	Zulu	zu‑ZA

Visão geral

API de Traduzir e Dublar

API de Tradução Visual

API de Lip Sync

API de Lip Sync reutilizável

Visão geral

Entradas

Saídas

Como funciona

Limitações de uso

Códigos de erro da API

Códigos de erro da tarefa

Idiomas suportados

Idiomas de origem

Idiomas de destino

​Entradas

​Saídas

​Como funciona

​Limitações de uso

​Códigos de erro da API

​Códigos de erro da tarefa

​Idiomas suportados

​Idiomas de origem

​Idiomas de destino

Entradas

Saídas

Como funciona

Limitações de uso

Códigos de erro da API

Códigos de erro da tarefa

Idiomas suportados

Idiomas de origem

Idiomas de destino