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

入力と出力

入力:
  • 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 エラーコード

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

ジョブエラーコード

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