Skip to main content

入力と出力

入力:
  • video_url
  • ソース言語とターゲット言語
  • [任意] glossary_ids
  • [任意] user_prompt
  • [任意] project_mode
出力:
  • 翻訳済み video_url
  • project_modeeditable の場合は project_url

仕組み

1

動画を公開アクセス可能な URL でホストする

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

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

ソース言語コードとターゲット言語コードに加え、用語やスタイルに関する任意の glossary ID またはプロンプト指示を含めてください。
3

待機するか、ステータスを照会する

処理が完了するまで、webhook コールバックを使用するか、返された task ID で API をポーリングしてください。
4

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

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

利用制限

  • この API は、API キーを作成できるユーザーのみ利用できます。
  • Studio プランが必要です。Studio 以外のユーザーは利用できません。
  • 入力は動画ファイルである必要があります。音声のみの書き出しには対応していません。
  • サポートされる入力の最大長は 20 分です。
  • ソース言語の自動検出には対応していません。サポートされているソース言語コードを明示的に指定してください。
  • 言語コードは IETF BCP 47 形式に従います。例: en-USzh-CNzh-CN-GUANGXI

API エラーコード

ジョブエラーコード

最終更新日 2026年7月9日