> ## 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？

可重用的口型同步 API 是我们口型同步 API 的优化版本，专为经常使用相同视觉参考生成口型同步视频的开发者设计。

### 有什么不同？

| 特性     | 口型同步 API         | 可重用的口型同步 API |
| :----- | :--------------- | :----------- |
| 参考上传   | 每次请求都需上传         | 上传一次，可多次重用   |
| 训练步骤   | 需要               | 不需要          |
| 生成输入   | 参考 + 音频          | 仅音频（重用参考）    |
| 生成速度   | 标准               | 更快（无需重新训练）   |
| 每次请求成本 | 5个积分基础 + 每分钟5个积分 | 每分钟5个积分      |

## 工作原理

<Steps>
  <Step title="使用先前任务 ID 创建模型">
    使用口型同步 API 中的先前任务 ID 在精确模式下创建可重用的口型同步模型。
  </Step>

  <Step title="在公共可访问的 URL 上托管音频资产">
    上传音频文件，以便我们的服务器可以检索它们。
  </Step>

  <Step title="发送带有适当参数的 API 请求">
    引用您托管的资产并指定您想要的模式（标准或精确）。
  </Step>

  <Step title="等待或查询状态">
    使用我们的 webhook 回调或通过作业 ID 轮询 API 直到处理完成。
  </Step>

  <Step title="下载视频输出">
    从提供的 URL 中获取完成的图片说话或口型同步视频。
  </Step>
</Steps>

## 使用限制：

* 你最多可以有 10 个并发作业（包括排队请求）。
* 预计排队时间：1–120 分钟，具体取决于系统负载。
* 处理时间：约 10 分钟。

<Note>
  如果视频或照片包含多个面孔，则只有检测到的最大面孔会进行口型同步。
</Note>

## 模型过期政策

通过模型创建 API 创建的模型具有基于活动的自动过期机制。

### 规则

1. 默认到期时间 每个可重用的口型同步模型在其创建日期或最后使用日期起保持有效 3 个月。
2. 自动延长 每次使用可重用的口型同步模型时（例如，在可重用的口型同步 API 请求中调用），其到期日期将从那时起延长 3 个月。
3. 到期 如果可重用的口型同步模型 3 个月内未使用，它将自动到期并可能被永久删除。
4. 重新激活 已过期的可重用的口型同步模型无法重新激活。要继续使用相同的配置，您必须重新提交口型同步作业并通过 API 重新创建可重用的口型同步模型。

## API 错误代码

| 代码   | 描述                       |
| ---- | ------------------------ |
| 5    | 请求参数无效。                  |
| 7    | 没有请求权限。                  |
| 104  | 点数不足。                    |
| 814  | 您的账户不是成员，无法调用 API。       |
| 1000 | 服务器内部错误。                 |
| 1301 | 回调挑战失败。                  |
| 1302 | API 密钥已被撤销。              |
| 1304 | API 密钥已达到最大并发请求数。        |
| 1502 | 您的音频驱动程序无效或无法下载。         |
| 1503 | 您的账户没有权限调用 API。          |
| 1504 | 在标准模式下或来自先前版本的任务不支持任务创建。 |
| 1305 | 仅允许 Studio 方案。           |
| 1506 | 模型已过期。                   |

## 作业错误代码

| 代码    | 描述        |
| ----- | --------- |
| 999   | 下载文件失败。   |
| 20611 | 视频触发流量限制。 |
