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

​
入力と出力

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

​
仕組み

1

資産を公開アクセス可能なURLにホストする

ビデオまたはオーディオ、オプションの字幕（.srt）をアップロードして、サーバーがそれらを取得できるようにします。
2

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

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

適切なパラメータを持つAPIリクエストを送信する

ソース/ターゲットの言語（例：en‑US → zh‑CN）、必要に応じて話者の範囲、および出力タイプを含めます。
4

待機またはステータスを照会する

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

出力をダウンロードする

提供されたURLから翻訳されたビデオ/オーディオと翻訳された字幕（.srt）を取得します。

​
利用制限

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

​
APIエラーコード

コード説明
5無効なリクエストパラメータです。
7リクエストの権限がありません。
104クレジットが不足しています。
814あなたのアカウントはメンバーではなく、APIを呼び出すことはできません。
1000内部サーバーエラーです。
1301コールバックチャレンジに失敗しました。
1302APIキーが取り消されました。
1304APIキーは同時リクエストの最大数に達しました。
1503あなたのアカウントはAPIを呼び出す権限がありません。
1305スタジオプランのみが許可されています。

​
ジョブエラーコード

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を更新することをサポートしています。

注意：“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)

​
対象言語

コード名前ロケールのバリアント
en英語en‑US, en‑GB, en‑AU, en‑CA, en‑HK, en‑KE, en‑NZ, en‑NG, en‑PH, en‑SG, en‑ZA, en‑TZ
zh中国語zh‑CN, zh‑HK, zh‑TW, zh‑CN‑shandong, zh‑CN‑liaoning, zh‑CN‑sichuan, zh‑CN‑henan, zh‑CN‑shaanxi, zh‑CN‑GUANGXI
wuu吳語wuu‑CN
esスペイン語es‑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アラビア語ar‑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
ruロシア語ru‑RU
ptポルトガル語pt‑PT, pt‑BR
frフランス語fr‑FR, fr‑CA, fr‑BE, fr‑CH
deドイツ語de‑DE, de‑AT, de‑CH
ko韓国語ko‑KR
ja日本語ja‑JP
hiヒンディー語hi‑IN
trトルコ語tr‑TR
filフィリピン語fil‑PH
fiフィンランド語fi‑FI
csチェコ語cs‑CZ
daデンマーク語da‑DK
nlオランダ語nl‑BE
plポーランド語pl‑PL
roルーマニア語ro‑RO
skスロバキア語sk‑SK
svスウェーデン語sv‑SE
hrクロアチア語hr‑HR
idインドネシア語id‑ID
itイタリア語it‑IT, it‑CH
bgブルガリア語bg‑BG
elギリシャ語el‑GR
msマレー語ms‑MY
taタミル語ta‑IN, ta‑MY, ta‑SG, ta‑LK
ukウクライナ語uk‑UA
thタイ語th‑TH
viベトナム語vi‑VN
amアムハラ語am‑ET
bnベンガル語bn‑IN, bn‑BD
asアッサム語as
bsボスニア語bs‑BA
caカタロニア語ca‑ES
etエストニア語et‑EE
euバスク語eu‑ES
glガリシア語gl‑ES
guグジャラート語gu
heヘブライ語he‑IL
huハンガリー語hu‑HU
iuイヌクティト語iu‑CANS‑CA, iu‑LATN‑CA
jvジャワ語jv‑ID
mkマケドニア語mk‑MK
mrマラーティー語mr
nbノルウェー語ブークモールnb‑NO
neネパール語ne‑NP
orオリヤ語or
paパンジャブ語pa
psパシュトー語ps‑AF
slスロベニア語sl‑SI
swスワヒリ語sw‑KE, sw‑TZ
teテルグ語te‑IN
urウルドゥー語ur, ur‑IN, ur‑PK
zuズールー語zu‑ZA
最終更新日 2026年5月26日