> ## 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="发送画面翻译请求">
    包括源语言和目标语言代码，以及用于术语和风格的可选术语表 ID 或提示说明。
  </Step>

  <Step title="等待或查询状态">
    使用你的 webhook 回调，或使用返回的任务 ID 轮询 API，直到处理完成。
  </Step>

  <Step title="下载翻译后的视频">
    任务完成后，从 `video_url` 获取翻译后的视频。如果你创建的是可编辑项目，可打开 `project_url` 在网页工作台中查看或编辑。
  </Step>
</Steps>

## 使用限制

* 只有能够创建 API Key 的用户才可以使用此 API。
* 需要 Studio 方案；非 Studio 用户不允许使用。
* 输入必须为视频文件。不支持仅导出音频。
* 支持的最长输入时长为 20 分钟。
* 不支持自动检测源语言。请显式传入受支持的源语言代码。
* 语言代码遵循 IETF BCP 47 风格，例如 `en-US`、`zh-CN`、`zh-CN-GUANGXI`。

## API 错误代码

| Code | Description          |
| ---- | -------------------- |
| 5    | 无效的请求参数。             |
| 7    | 无请求权限。               |
| 104  | 点数不足。                |
| 814  | 你的账号不是成员，不允许调用该 API。 |
| 1000 | 服务器内部错误。             |
| 1301 | 回调验证失败。              |
| 1302 | API key 已被撤销。        |
| 1304 | API key 已达到最大并发请求数。  |
| 1503 | 你的账号未获授权调用该 API。     |
| 1305 | 仅允许 Studio 方案。       |

## 任务错误代码

| Code  | Description      |
| ----- | ---------------- |
| 40002 | 上传的文件没有视频流。      |
| 40010 | 转码失败。            |
| 40050 | 翻译失败。            |
| 40020 | OCR 提取失败。        |
| 40032 | 视频中没有有效的标注框。     |
| 40040 | OCR 与标注框匹配失败。    |
| 40041 | 未能将任何标注框匹配到 OCR。 |
| 40060 | 标注框优化失败。         |
| 40061 | 在优化过程中提取样式失败。    |
| 40080 | 生成预览视频失败。        |