Zum Hauptinhalt springen

Eingaben & Ausgaben

Eingabe:
  • media_url
  • Quellsprache & Zielsprache
  • [optional] subtitle_url oder ocr_text_box (für genauere Spracherkennung)
Ausgabe:
  • media (Video oder Audio)
  • übersetzte subtitle_url (SRT)

So funktioniert es

1

Laden Sie Ihre Ressourcen unter einer öffentlich zugänglichen URL hoch

Laden Sie Ihr Video oder Audio sowie optional die Untertitel (.srt) hoch, damit unsere Server sie abrufen können.
2

Optional OCR-Textbereich angeben

Wenn es Text auf dem Bildschirm gibt, der übersetzt werden soll, geben Sie ein normiertes OCR-Feld (x, y, Breite, Höhe) von 0–1 an; der Ursprung befindet sich in der oberen linken Ecke des Rahmens.
3

Senden Sie eine API-Anfrage mit den entsprechenden Parametern

Fügen Sie Quell-/Zielsprachen hinzu (z. B. en‑US → zh‑CN), wenn nötig, den Sprecherbereich und den Exporttyp.
4

Warten oder Status abfragen

Verwenden Sie unseren Webhook-Rückruf oder fragen Sie die API mit Ihrer Aufgaben-ID ab, bis die Verarbeitung abgeschlossen ist.
5

Ergebnisse herunterladen

Rufen Sie das übersetzte Video/Audio und die übersetzten Untertitel (.srt) von den angegebenen URLs ab.

Nutzungsbeschränkung

  • Nur Benutzer, die API-Schlüssel erstellen können, dürfen diese API verwenden.
  • Ein Business-Plan ist erforderlich; Nicht-Geschäftsnutzer sind nicht erlaubt.
  • Die gleichzeitige Nutzung ist unabhängig von LipSync begrenzt; in der Warteschlange befindliche Anfragen werden gezählt.
  • Der Sprachcode folgt dem IETF BCP 47-Standard, z. B. en‑US.

API-Fehlercodes

CodeDescription
5Invalid request parameters.
7No permission to request.
104Insufficient credits.
814Your account is not a member and is not allowed to call the API.
1000Internal Server Error.
1301Callback Challenge failed.
1302API key has been revoked.
1304API key has reached the maximum number of concurrent requests.
1503Your account is not authorized to call the API.
1305Only business plan is allowed.

Job-Fehlercodes

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

Unterstützte Sprachen

Quellsprachen

Hinweis: “auto” wird unterstützt, um die Ausgangssprache automatisch zu erkennen und SourceLanguage bei Erkennung zu aktualisieren.
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)

Zielsprache

CodeNameLocale variants
enEnglishen‑US, en‑GB, en‑AU, en‑CA
zhChinesezh‑CN, zh‑HK, zh‑TW
esSpanishes‑ES, es‑MX, es‑US
arArabicar‑EG, ar‑SA, ar‑AE, ar‑MA, ar‑SY
ruRussianru‑RU
ptPortuguesept‑PT, pt‑BR
frFrenchfr‑FR, fr‑CA, fr‑BE, fr‑CH
deGermande‑DE, de‑AT, de‑CH
koKoreanko‑KR
jaJapaneseja‑JP
hiHindihi‑IN
trTurkishtr‑TR
filFilipinofil‑PH
fiFinnishfi‑FI
csCzechcs‑CZ
daDanishda‑DK
nlDutchnl‑BE
plPolishpl‑PL
roRomanianro‑RO
skSlovaksk‑SK
svSwedishsv‑SE
hrCroatianhr‑HR
idIndonesianid‑ID
itItalianit‑IT, it‑CH
bgBulgarianbg‑BG
elGreekel‑GR
msMalayms‑MY
taTamilta‑IN
ukUkrainianuk‑UA
thThaith‑TH
viVietnamesevi‑VN
amAmharicam‑ET
bnBengalibn‑IN, bn‑BD
bsBosnianbs‑BA
caCatalanca‑ES
etEstonianet‑EE
euBasqueeu‑ES
glGaliciangl‑ES
heHebrewhe‑IL
huHungarianhu‑HU
jvJavanesejv‑ID
mkMacedonianmk‑MK
nbNorwegian Bokmålnb‑NO
neNepaline‑NP
psPashtops‑AF
slSloveniansl‑SI
swSwahilisw‑KE, sw‑TZ
teTelugute‑IN
zuZuluzu‑ZA