メインコンテンツへスキップ
ビジュアル翻訳 API は、動画内の画面上のテキストを、レイアウト、スタイル、アニメーションを保持したままローカライズします。プレゼンテーション、製品デモ、マーケティング動画、その他テキストが埋め込まれた動画のビジュアルテキスト翻訳を自動化するために使用できます。この API は翻訳済みの動画を返し、必要に応じて Vozo Web アプリで編集可能なプロジェクトを作成することもできます。

入力

出力

  • 翻訳済みの video_url
  • project_mode が editable の場合の project_url

仕組み

1

一般公開されている URL で動画をホストする

サーバーが取得できるように入力動画をアップロードします。動画は 20 分以内にしてください。
2

ビジュアル翻訳リクエストを送信する

ジョブに必要な必須入力と任意の設定を指定します。
3

完了を待つ、またはステータスを照会する

webhook コールバックを使用するか、返されたタスク ID で API をポーリングし、処理の完了を待ちます。
4

翻訳済み動画をダウンロードする

ジョブが完了したら、返された URL から翻訳済み動画を取得します。編集可能なプロジェクトを作成した場合は、プロジェクト URL からダッシュボードで確認または編集できます。

利用制限

  • API キーを作成できるユーザーのみ、この API を利用できます。
  • デフォルトの同時実行数の上限は 10 ジョブです。この上限はチームの全メンバーで共有されます。詳しくは同時実行数の上限をご覧ください。
  • 入力は動画ファイルである必要があります。音声のみの書き出しには対応していません。
  • 対応している入力動画の最大長は 20 分です。
  • ソース言語の自動検出には対応していません。対応しているソース言語コードを明示的に指定してください。
  • 言語コードは IETF BCP 47 形式に従います。例:en-US、zh-CN、zh-CN-GUANGXI。

| Code | 説明 || 5 | リクエストパラメータが無効です。 || 7 | リクエスト権限がありません。 || 104 | クレジットが不足しています。 || 814 | あなたのアカウントはメンバーではないため、API を呼び出すことはできません。 || 1000 | 内部サーバーエラー。 || 1301 | Callback Challenge に失敗しました。 || 1302 | API キーは取り消されています。 || 1304 | API キーが同時リクエスト数の上限に達しました。 || 1503 | あなたのアカウントには API を呼び出す権限がありません。 |

| Code | 説明 || 40002 | アップロードされたファイルに動画ストリームがありません。 || 40010 | トランスコードに失敗しました。 || 40050 | 翻訳に失敗しました。 || 40020 | OCR 抽出に失敗しました。 || 40032 | 動画内に有効なコールアウトがありません。 || 40040 | OCR とコールアウトのマッチングに失敗しました。 || 40041 | いずれのコールアウトも OCR と一致しませんでした。 || 40060 | コールアウトの調整に失敗しました。 || 40061 | 調整時のスタイル抽出に失敗しました。 || 40080 | プレビュー動画の生成に失敗しました。 |

ソース言語

自動検出はサポートされていません。以下のいずれかの言語コードを指定してください。

| コード | 名称 || sq-AL | アルバニア語 || ar-EG | アラビア語 || az-AZ | アゼルバイジャン語 || eu-ES | バスク語 || bs-BA | ボスニア語 || bg-BG | ブルガリア語 || yue-CN | 広東語 || ca-ES | カタルーニャ語 || zh-CN | 中国語(簡体字) || zh-TW | 中国語(繁体字) || hr-HR | クロアチア語 || cs-CZ | チェコ語 || da-DK | デンマーク語 || nl-NL | オランダ語 || en-US | 英語 || et-EE | エストニア語 || fil-PH | フィリピノ語 || fi-FI | フィンランド語 || fr-FR | フランス語 || gl-ES | ガリシア語 || de-DE | ドイツ語 || el-GR | ギリシャ語 || hi-IN | ヒンディー語 || hu-HU | ハンガリー語 || is-IS | アイスランド語 || id-ID | インドネシア語 || ga-IE | アイルランド語 || it-IT | イタリア語 || ja-JP | 日本語 || kk-KZ | カザフ語 || ko-KR | 韓国語 || lv-LV | ラトビア語 || lt-LT | リトアニア語 || mk-MK | マケドニア語 || ms-MY | マレー語 || mt-MT | マルタ語 || mr-IN | マラーティー語 || mn-MN | モンゴル語 || ne-NP | ネパール語 || nb-NO | ノルウェー語 || fa-IR | ペルシア語 || pl-PL | ポーランド語 || pt-PT | ポルトガル語 || ro-RO | ルーマニア語 || ru-RU | ロシア語 || sr-RS | セルビア語 || sk-SK | スロバキア語 || sl-SI | スロベニア語 || es-ES | スペイン語 || sw-KE | スワヒリ語 || sv-SE | スウェーデン語 || ta-IN | タミル語 || th-TH | タイ語 || tr-TR | トルコ語 || uk-UA | ウクライナ語 || ur-IN | ウルドゥー語 || uz-UZ | ウズベク語 || vi-VN | ベトナム語 |

| コード | 名称 | ロケールのバリエーション || 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年11月2日