Passer au contenu principal

​
Entrées et Sorties

Entrée :
  • media_url
  • langue source & langue cible
  • [optionnel] subtitle_url ou ocr_text_box (pour une reconnaissance vocale plus précise)
  • [optionnel] glossary_ids
Glossaire Pn Sortie :
  • média (vidéo ou audio)
  • sous-titres traduits_url (SRT)

​
Comment ça fonctionne

1

Hébergez vos ressources à une URL publiquement accessible

Téléchargez votre vidéo ou audio, et un sous-titre (.srt) optionnel afin que nos serveurs puissent les récupérer.
2

Fournissez éventuellement la région de texte OCR

S’il y a du texte à l’écran à traduire, spécifiez une boîte OCR normalisée (x, y, largeur, hauteur) de 0 à 1 ; l’origine est en haut à gauche du cadre.
3

Envoyez une requête API avec les paramètres appropriés

Incluez les langues source/cible (par exemple, en-US → zh-CN), la plage des locuteurs si nécessaire, et le type d’exportation.
4

Attendez ou interrogez le statut

Utilisez notre rappel webhook ou interrogez l’API avec votre ID de tâche jusqu’à ce que le traitement soit terminé.
5

Téléchargez les sorties

Récupérez la vidéo/audio traduite et les sous-titres traduits (.srt) à partir des URL fournies.

​
Limitations d’utilisation

  • Seuls les utilisateurs pouvant créer des clés API peuvent utiliser cette API.
  • Un plan Studio est requis ; les utilisateurs non Studio ne sont pas autorisés.
  • La capacité de simultanéité est limitée indépendamment de LipSync ; les requêtes en file d’attente sont comptées.
  • Le code de langue suit la norme IETF BCP 47, par exemple, en-US.

​
Codes d’erreur de l’API

CodeDescription
5Paramètres de demande invalides.
7Pas de permission pour faire la demande.
104Crédits insuffisants.
814Votre compte n’est pas membre et n’est pas autorisé à appeler l’API.
1000Erreur interne du serveur.
1301Échec du défi de rappel.
1302La clé API a été révoquée.
1304La clé API a atteint le nombre maximum de requêtes simultanées.
1503Votre compte n’est pas autorisé à appeler l’API.
1305Seul le plan Studio est autorisé.

​
Codes d’erreur de travail

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

​
Langues Source

​
Remarque : “auto” est pris en charge pour détecter automatiquement la langue source et mettre à jour SourceLanguage lorsqu’elle est détectée.

Remarque : “auto” est pris en charge pour détecter automatiquement la langue source et mettre à jour SourceLanguage lorsqu’elle est détectée.
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)

​
Langues cibles

CodeNomVariantes locales
enAnglaisen‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ
zhChinoiszh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI
wuuWu Chinoiswuu‑CN
esEspagnoles‑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
arArabear‑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
ruRusseru‑RU
ptPortugaispt‑PT, pt‑BR
frFrançaisfr‑FR, fr‑CA, fr‑BE, fr‑CH
deAllemandde‑DE, de‑AT, de‑CH
koCoréenko‑KR
jaJaponaisja‑JP
hiHindihi‑IN
trTurctr‑TR
filPhilippinfil‑PH
fiFinnoisfi‑FI
csTchèquecs‑CZ
daDanoisda‑DK
nlNéerlandaisnl‑BE
plPolonaispl‑PL
roRoumainro‑RO
skSlovaquesk‑SK
svSuédoissv‑SE
hrCroatehr‑HR
idIndonésienid‑ID
itItalienit‑IT, it‑CH
bgBulgarebg‑BG
elGrecel‑GR
msMalaisms‑MY
taTamoulta‑IN, ta‑MY, ta‑SG, ta‑LK
ukUkrainienuk‑UA
thThaïlandaisth‑TH
viVietnamiensvi‑VN
amAmhariqueam‑ET
bnBengalibn‑IN, bn‑BD
asAssamias
bsBosniaquebs‑BA
caCatalanca‑ES
etEstonienet‑EE
euBasqueeu‑ES
glGaliciengl‑ES
guGujaratigu
heHébreuhe‑IL
huHongroishu‑HU
iuInuktitutiu‑CANS‑CA, iu‑LATN‑CA
jvJavanaisjv‑ID
mkMacédonienmk‑MK
mrMarathimr
nbNorvégien Bokmålnb‑NO
neNépaline‑NP
orOriyaor
paPendjabipa
psPachtops‑AF
slSlovènesl‑SI
swSwahilisw‑KE, sw‑TZ
teTélougoute‑IN
urOurdouur, ur‑IN, ur‑PK
zuZoulouzu‑ZA
Dernière modification le 26 mai 2026