> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

> ビジュアル翻訳 API

## 入力と出力

入力:

* video\_url
* ソース言語とターゲット言語
* \[任意] glossary\_ids
* \[任意] user\_prompt
* \[任意] project\_mode

出力:

* 翻訳済み video\_url
* `project_mode` が `editable` の場合は project\_url

## 仕組み

<Steps>
  <Step title="動画を公開アクセス可能な URL でホストする">
    サーバーが取得できるよう、入力動画をアップロードしてください。動画の長さは 20 分以内である必要があります。
  </Step>

  <Step title="ビジュアル翻訳リクエストを送信する">
    ソース言語コードとターゲット言語コードに加え、用語やスタイルに関する任意の glossary ID またはプロンプト指示を含めてください。
  </Step>

  <Step title="待機するか、ステータスを照会する">
    処理が完了するまで、webhook コールバックを使用するか、返された task ID で API をポーリングしてください。
  </Step>

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

## 利用制限

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

## API エラーコード

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

## ジョブエラーコード

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