Saltar para o conteúdo principal

​
Entradas & Saídas

Entrada:
  • media_url
  • idioma de origem & idioma de destino
  • [opcional] subtitle_url ou ocr_text_box (para reconhecimento de fala mais preciso)
  • [opcional] glossary_ids
Glossário Pn Saída:
  • mídia (vídeo ou áudio)
  • url de legenda traduzida_url (SRT)

​
Como funciona

1

Hospede seus ativos em uma URL acessível publicamente

Carregue seu vídeo ou áudio e a legenda opcional (.srt) para que nossos servidores possam recuperá-los.
2

Forneça opcionalmente a região de texto OCR

Se houver texto na tela para traduzir, especifique uma caixa OCR normalizada (x, y, largura, altura) de 0 a 1; a origem é no canto superior esquerdo do quadro.
3

Envie uma solicitação API com os parâmetros apropriados

Inclua os idiomas de origem/alvo (por exemplo, en‑US → zh‑CN), faixa de falante se necessário e tipo de exportação.
4

Aguarde ou consulte o status

Use nosso callback de webhook ou consulte a API com seu ID de tarefa até que o processamento esteja completo.
5

Baixar saídas

Recupere o vídeo/áudio traduzido e a legenda traduzida (.srt) das URLs fornecidas.

​
Limitação de Uso

  • Apenas usuários que podem criar Chaves da API podem usar esta API.
  • É necessário um plano Studio; usuários não Studio não são permitidos.
  • A concorrência é limitada independentemente do LipSync; solicitações em fila são contadas.
  • O código do idioma segue o padrão IETF BCP 47, por exemplo, en‑US.

​
Códigos de Erro da API

CódigoDescrição
5Parâmetros de solicitação inválidos.
7Sem permissão para solicitar.
104Créditos insuficientes.
814Sua conta não é um membro e não pode chamar a API.
1000Erro Interno do Servidor.
1301Falha no Desafio de Callback.
1302A chave da API foi revogada.
1304A chave da API alcançou o número máximo de requisições simultâneas.
1503Sua conta não está autorizada a chamar a API.
1305Somente o plano Studio é permitido.

​
Códigos de Erro do Trabalho

CodeDescription
10001Uploaded file has no video stream
10002Uploaded video has no audio stream
10003Transcoding failed
10004Failed to generate HLS output
10005Video cropping failed
10010Voice separation failed (speech vs. background)
10020Automatic speech recognition (ASR) failed
10021Multi‑speaker ASR failed
10022Speaker diarization (Chinese) failed
10023Failed to generate full subtitles
10030Translation failed
10031Mixed languages detected; aggregation failed after punctuation adjustment
10032OCR extraction failed
10033OCR language not supported
10034Subtitle (SRT) alignment failed
10040Voice cloning failed
10041No recognized speech content
10042No speech detected
10043Re‑cloning voice failed
10044Preview text for TTS is empty
10045Failed to generate preview audio

​
Idiomas de Origem

​
Nota: “auto” é suportado para detectar automaticamente o idioma de origem e atualizar SourceLanguage quando detectado.

Nota: “auto” é suportado para detectar automaticamente o idioma de origem e atualizar SourceLanguage quando detectado.
CodeName
autoAuto Detect
en-USEnglish (United States)
en-GBEnglish (United Kingdom)
en-AUEnglish (Australia)
en-CAEnglish (Canada)
en-GHEnglish (Ghana)
en-HKEnglish (Hong Kong)
en-IEEnglish (Ireland)
en-INEnglish (India)
en-KEEnglish (Kenya)
en-NGEnglish (Nigeria)
en-NZEnglish (New Zealand)
en-PHEnglish (Philippines)
en-SGEnglish (Singapore)
en-TZEnglish (Tanzania)
en-ZAEnglish (South Africa)
zh-CNChinese (China, Simplified)
zh-HKChinese (Hong Kong, Traditional)
zh-TWChinese (Taiwan, Traditional)
es-ESSpanish (Spain)
es-MXSpanish (Mexico)
es-USSpanish (United States)
es-ARSpanish (Argentina)
es-BOSpanish (Bolivia)
es-CLSpanish (Chile)
es-COSpanish (Colombia)
es-CRSpanish (Costa Rica)
es-CUSpanish (Cuba)
es-DOSpanish (Dominican Republic)
es-ECSpanish (Ecuador)
es-GQSpanish (Equatorial Guinea)
es-GTSpanish (Guatemala)
es-HNSpanish (Honduras)
es-NISpanish (Nicaragua)
es-PASpanish (Panama)
es-PESpanish (Peru)
es-PRSpanish (Puerto Rico)
es-PYSpanish (Paraguay)
es-SVSpanish (El Salvador)
es-UYSpanish (Uruguay)
es-VESpanish (Venezuela)
ar-EGArabic (Egypt)
ar-SAArabic (Saudi Arabia)
ar-AEArabic (United Arab Emirates)
ar-MAArabic (Morocco)
ar-SYArabic (Syria)
ru-RURussian (Russia)
pt-PTPortuguese (Portugal)
pt-BRPortuguese (Brazil)
fr-BEFrench (Belgium)
fr-CAFrench (Canada)
fr-CHFrench (Switzerland)
fr-FRFrench (France)
de-DEGerman (Germany)
de-ATGerman (Austria)
de-CHGerman (Switzerland)
ko-KRKorean (South Korea)
ja-JPJapanese (Japan)
hi-INHindi (India)
tr-TRTurkish (Turkey)
ur-INUrdu (India)
fil-PHFilipino (Philippines)
fi-FIFinnish (Finland)
cs-CZCzech (Czech Republic)
hu-HUHungarian (Hungary)
da-DKDanish (Denmark)
nl-BEDutch (Belgium)
pl-PLPolish (Poland)
ro-RORomanian (Romania)
sk-SKSlovak (Slovakia)
sv-SESwedish (Sweden)
hr-HRCroatian (Croatia)
id-IDIndonesian (Indonesia)
it-ITItalian (Italy)
it-CHItalian (Switzerland)
bg-BGBulgarian (Bulgaria)
el-GRGreek (Greece)
ms-MYMalay (Malaysia)
ta-INTamil (India)
uk-UAUkrainian (Ukraine)
sq-ALAlbanian (Albania)
az-AZAzerbaijani (Azerbaijan)
eu-ESBasque (Spain)
bn-INBengali (India)
bs-BABosnian (Bosnia and Herzegovina)
yue-CNCantonese (China)
ca-ESCatalan (Spain)
gl-ESGalician (Spain)
gu-INGujarati (India)
is-ISIcelandic (Iceland)
kn-INKannada (India)
kk-KZKazakh (Kazakhstan)
lv-LVLatvian (Latvia)
lt-LTLithuanian (Lithuania)
mk-MKMacedonian (North Macedonia)
ml-INMalayalam (India)
mt-MTMaltese (Malta)
mr-INMarathi (India)
mn-MNMongolian (Mongolia)
ne-NPNepali (Nepal)
nb-NONorwegian Bokmål (Norway)
pa-INPunjabi (India)
sl-SISlovenian (Slovenia)
so-SOSomali (Somalia)
sr-RSSerbian (Serbia)
sw-KESwahili (Kenya)
sw-TZSwahili (Tanzania)
uz-UZUzbek (Uzbekistan)
vi-VNVietnamese (Vietnam)
he-ILHebrew (Israel)
fa-IRPersian (Iran)
th-THThai (Thailand)

​
Idiomas Alvo

CódigoNomeVariantes de Localidade
enInglêsen‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ
zhChinêszh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI
wuuChinês Wuwuu‑CN
esEspanholes‑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Árabear‑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
ruRussoru‑RU
ptPortuguêspt‑PT, pt‑BR
frFrancêsfr‑FR, fr‑CA, fr‑BE, fr‑CH
deAlemãode‑DE, de‑AT, de‑CH
koCoreanoko‑KR
jaJaponêsja‑JP
hiHindihi‑IN
trTurcotr‑TR
filFilipinofil‑PH
fiFinlandêsfi‑FI
csChecocs‑CZ
daDinamarquêsda‑DK
nlNeerlandêsnl‑BE
plPolonêspl‑PL
roRomenoro‑RO
skEslovacosk‑SK
svSuecosv‑SE
hrCroatahr‑HR
idIndonésioid‑ID
itItalianoit‑IT, it‑CH
bgBúlgarobg‑BG
elGregoel‑GR
msMalaioms‑MY
taTâmilta‑IN, ta‑MY, ta‑SG, ta‑LK
ukUcranianouk‑UA
thTailandêsth‑TH
viVietnamitavi‑VN
amAmáricoam‑ET
bnBengalibn‑IN, bn‑BD
asAssamesas
bsBósniobs‑BA
caCatalãoca‑ES
etEstonianoet‑EE
euBascoeu‑ES
glGalegogl‑ES
guGujaratigu
heHebraicohe‑IL
huHúngarohu‑HU
iuInuktitutiu‑CANS‑CA, iu‑LATN‑CA
jvJavanêsjv‑ID
mkMacedôniomk‑MK
mrMarathimr
nbBokmål Norueguêsnb‑NO
neNepaline‑NP
orOriyaor
paPunjabipa
psPashtops‑AF
slEslovenosl‑SI
swSuaílisw‑KE, sw‑TZ
teTelugute‑IN
urUrduur, ur‑IN, ur‑PK
zuZuluzu‑ZA
Última modificação em 26 de maio de 2026