メインコンテンツへスキップ

入力と出力

入力:
  • media_url
  • ソース言語とターゲット言語
  • [オプション] subtitle_url または ocr_text_box (より正確な音声認識用)
出力:
  • メディア (動画または音声)
  • 翻訳された subtitle_url (SRT)

仕組み

1

公開アクセス可能なURLにあなたのアセットをホストしてください

動画または音声、オプションの字幕 (.srt) をアップロードして、サーバーがそれらを取得できるようにします。
2

オプションでOCRテキスト領域を提供

翻訳する画面上のテキストがある場合は、フレームの左上を原点とし、0〜1の範囲で正規化されたOCRボックス (x, y, 幅, 高さ) を指定します。
3

適切なパラメーターでAPIリクエストを送信

必要に応じて、ソース/ターゲット言語 (例: en‑US → zh‑CN)、話者範囲、およびエクスポート形式を含めます。
4

完了を待つか状態をクエリ

処理が完了するまで、Webhookコールバックを使用するか、タスクIDを使用してAPIをポーリングします。
5

出力をダウンロード

提供されたURLから翻訳された動画/音声と翻訳された字幕 (.srt) を取得します。

使用制限

  • APIキーを作成できるユーザーのみがこのAPIを使用できます。
  • ビジネスプランが必要です。非ビジネスユーザーは許可されていません。
  • 同時実行はリップシンクとは独立して制限されており、キューに入れられたリクエストがカウントされます。
  • 言語コードはIETF BCP 47標準に従い、例: en‑USです。

APIエラーコード

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.

ジョブエラーコード

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

サポートされている言語

ソース言語

注: “auto” はソース言語を自動的に検出し、検出されたときにSourceLanguageを更新することをサポートしています。
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)

ターゲット言語

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