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)
- media (vidéo ou audio)
- subtitle_url traduit (SRT)
Comment ça fonctionne
Hébergez vos ressources à une URL accessible au public
Téléchargez votre vidéo ou audio, et une sous-titre optionnelle (.srt) afin que nos serveurs puissent les récupérer.
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 dans le coin supérieur gauche du cadre.
Envoyez une demande API avec les paramètres appropriés
Inclure les langues source/cible (par exemple, en‑US → zh‑CN), la plage de locuteurs si nécessaire, et le type d’exportation.
Attendre ou interroger le statut
Utilisez notre rappel webhook ou interrogez l’API avec votre ID de tâche jusqu’à ce que le traitement soit terminé.
Limitation d’utilisation
- Seuls les utilisateurs qui peuvent créer des clés API peuvent utiliser cette API.
- Un plan professionnel est requis ; les utilisateurs non professionnels ne sont pas autorisés.
- La concurrence est limitée indépendamment de LipSync ; les demandes en file d’attente sont comptées.
- Le code de langue suit la norme IETF BCP 47, par exemple, en‑US.
Codes d’erreur API
| Code | Description |
|---|---|
| 5 | Invalid request parameters. |
| 7 | No permission to request. |
| 104 | Insufficient credits. |
| 814 | Your account is not a member and is not allowed to call the API. |
| 1000 | Internal Server Error. |
| 1301 | Callback Challenge failed. |
| 1302 | API key has been revoked. |
| 1304 | API key has reached the maximum number of concurrent requests. |
| 1503 | Your account is not authorized to call the API. |
| 1305 | Only business plan is allowed. |
Codes d’erreur de tâche
| Code | Description |
|---|---|
| 10001 | Uploaded file has no video stream |
| 10002 | Uploaded video has no audio stream |
| 10003 | Transcoding failed |
| 10004 | Failed to generate HLS output |
| 10005 | Video cropping failed |
| 10010 | Voice separation failed (speech vs. background) |
| 10020 | Automatic speech recognition (ASR) failed |
| 10021 | Multi‑speaker ASR failed |
| 10022 | Speaker diarization (Chinese) failed |
| 10023 | Failed to generate full subtitles |
| 10030 | Translation failed |
| 10031 | Mixed languages detected; aggregation failed after punctuation adjustment |
| 10032 | OCR extraction failed |
| 10033 | OCR language not supported |
| 10034 | Subtitle (SRT) alignment failed |
| 10040 | Voice cloning failed |
| 10041 | No recognized speech content |
| 10042 | No speech detected |
| 10043 | Re‑cloning voice failed |
| 10044 | Preview text for TTS is empty |
| 10045 | Failed to generate preview audio |
Langues prises en charge
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.| Code | Name |
|---|---|
| auto | Auto Detect |
| en-US | English (United States) |
| en-GB | English (United Kingdom) |
| en-AU | English (Australia) |
| en-CA | English (Canada) |
| en-GH | English (Ghana) |
| en-HK | English (Hong Kong) |
| en-IE | English (Ireland) |
| en-IN | English (India) |
| en-KE | English (Kenya) |
| en-NG | English (Nigeria) |
| en-NZ | English (New Zealand) |
| en-PH | English (Philippines) |
| en-SG | English (Singapore) |
| en-TZ | English (Tanzania) |
| en-ZA | English (South Africa) |
| zh-CN | Chinese (China, Simplified) |
| zh-HK | Chinese (Hong Kong, Traditional) |
| zh-TW | Chinese (Taiwan, Traditional) |
| es-ES | Spanish (Spain) |
| es-MX | Spanish (Mexico) |
| es-US | Spanish (United States) |
| es-AR | Spanish (Argentina) |
| es-BO | Spanish (Bolivia) |
| es-CL | Spanish (Chile) |
| es-CO | Spanish (Colombia) |
| es-CR | Spanish (Costa Rica) |
| es-CU | Spanish (Cuba) |
| es-DO | Spanish (Dominican Republic) |
| es-EC | Spanish (Ecuador) |
| es-GQ | Spanish (Equatorial Guinea) |
| es-GT | Spanish (Guatemala) |
| es-HN | Spanish (Honduras) |
| es-NI | Spanish (Nicaragua) |
| es-PA | Spanish (Panama) |
| es-PE | Spanish (Peru) |
| es-PR | Spanish (Puerto Rico) |
| es-PY | Spanish (Paraguay) |
| es-SV | Spanish (El Salvador) |
| es-UY | Spanish (Uruguay) |
| es-VE | Spanish (Venezuela) |
| ar-EG | Arabic (Egypt) |
| ar-SA | Arabic (Saudi Arabia) |
| ar-AE | Arabic (United Arab Emirates) |
| ar-MA | Arabic (Morocco) |
| ar-SY | Arabic (Syria) |
| ru-RU | Russian (Russia) |
| pt-PT | Portuguese (Portugal) |
| pt-BR | Portuguese (Brazil) |
| fr-BE | French (Belgium) |
| fr-CA | French (Canada) |
| fr-CH | French (Switzerland) |
| fr-FR | French (France) |
| de-DE | German (Germany) |
| de-AT | German (Austria) |
| de-CH | German (Switzerland) |
| ko-KR | Korean (South Korea) |
| ja-JP | Japanese (Japan) |
| hi-IN | Hindi (India) |
| tr-TR | Turkish (Turkey) |
| ur-IN | Urdu (India) |
| fil-PH | Filipino (Philippines) |
| fi-FI | Finnish (Finland) |
| cs-CZ | Czech (Czech Republic) |
| hu-HU | Hungarian (Hungary) |
| da-DK | Danish (Denmark) |
| nl-BE | Dutch (Belgium) |
| pl-PL | Polish (Poland) |
| ro-RO | Romanian (Romania) |
| sk-SK | Slovak (Slovakia) |
| sv-SE | Swedish (Sweden) |
| hr-HR | Croatian (Croatia) |
| id-ID | Indonesian (Indonesia) |
| it-IT | Italian (Italy) |
| it-CH | Italian (Switzerland) |
| bg-BG | Bulgarian (Bulgaria) |
| el-GR | Greek (Greece) |
| ms-MY | Malay (Malaysia) |
| ta-IN | Tamil (India) |
| uk-UA | Ukrainian (Ukraine) |
| sq-AL | Albanian (Albania) |
| az-AZ | Azerbaijani (Azerbaijan) |
| eu-ES | Basque (Spain) |
| bn-IN | Bengali (India) |
| bs-BA | Bosnian (Bosnia and Herzegovina) |
| yue-CN | Cantonese (China) |
| ca-ES | Catalan (Spain) |
| gl-ES | Galician (Spain) |
| gu-IN | Gujarati (India) |
| is-IS | Icelandic (Iceland) |
| kn-IN | Kannada (India) |
| kk-KZ | Kazakh (Kazakhstan) |
| lv-LV | Latvian (Latvia) |
| lt-LT | Lithuanian (Lithuania) |
| mk-MK | Macedonian (North Macedonia) |
| ml-IN | Malayalam (India) |
| mt-MT | Maltese (Malta) |
| mr-IN | Marathi (India) |
| mn-MN | Mongolian (Mongolia) |
| ne-NP | Nepali (Nepal) |
| nb-NO | Norwegian Bokmål (Norway) |
| pa-IN | Punjabi (India) |
| sl-SI | Slovenian (Slovenia) |
| so-SO | Somali (Somalia) |
| sr-RS | Serbian (Serbia) |
| sw-KE | Swahili (Kenya) |
| sw-TZ | Swahili (Tanzania) |
| uz-UZ | Uzbek (Uzbekistan) |
| vi-VN | Vietnamese (Vietnam) |
| he-IL | Hebrew (Israel) |
| fa-IR | Persian (Iran) |
| th-TH | Thai (Thailand) |
Langues Cibles
| Code | Name | Locale variants |
|---|---|---|
| en | English | en‑US, en‑GB, en‑AU, en‑CA |
| zh | Chinese | zh‑CN, zh‑HK, zh‑TW |
| es | Spanish | es‑ES, es‑MX, es‑US |
| ar | Arabic | ar‑EG, ar‑SA, ar‑AE, ar‑MA, ar‑SY |
| ru | Russian | ru‑RU |
| pt | Portuguese | pt‑PT, pt‑BR |
| fr | French | fr‑FR, fr‑CA, fr‑BE, fr‑CH |
| de | German | de‑DE, de‑AT, de‑CH |
| ko | Korean | ko‑KR |
| ja | Japanese | ja‑JP |
| hi | Hindi | hi‑IN |
| tr | Turkish | tr‑TR |
| fil | Filipino | fil‑PH |
| fi | Finnish | fi‑FI |
| cs | Czech | cs‑CZ |
| da | Danish | da‑DK |
| nl | Dutch | nl‑BE |
| pl | Polish | pl‑PL |
| ro | Romanian | ro‑RO |
| sk | Slovak | sk‑SK |
| sv | Swedish | sv‑SE |
| hr | Croatian | hr‑HR |
| id | Indonesian | id‑ID |
| it | Italian | it‑IT, it‑CH |
| bg | Bulgarian | bg‑BG |
| el | Greek | el‑GR |
| ms | Malay | ms‑MY |
| ta | Tamil | ta‑IN |
| uk | Ukrainian | uk‑UA |
| th | Thai | th‑TH |
| vi | Vietnamese | vi‑VN |
| am | Amharic | am‑ET |
| bn | Bengali | bn‑IN, bn‑BD |
| bs | Bosnian | bs‑BA |
| ca | Catalan | ca‑ES |
| et | Estonian | et‑EE |
| eu | Basque | eu‑ES |
| gl | Galician | gl‑ES |
| he | Hebrew | he‑IL |
| hu | Hungarian | hu‑HU |
| jv | Javanese | jv‑ID |
| mk | Macedonian | mk‑MK |
| nb | Norwegian Bokmål | nb‑NO |
| ne | Nepali | ne‑NP |
| ps | Pashto | ps‑AF |
| sl | Slovenian | sl‑SI |
| sw | Swahili | sw‑KE, sw‑TZ |
| te | Telugu | te‑IN |
| zu | Zulu | zu‑ZA |