跳转到主要内容

​
为什么使用可重用的对口型 API？

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

​
有什么不同？

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

​
工作原理

1

使用先前任务 ID 创建模型

使用对口型 API 中的先前任务 ID 在精确模式下创建可重用的对口型模型。
2

在公共可访问的 URL 上托管音频资产

上传音频文件，以便我们的服务器可以检索它们。
3

发送带有适当参数的 API 请求

引用你的托管资产，并指定你所需的模式（标准或 精确）。
4

等待或查询状态

使用我们的 Webhook 回调或通过你的作业 ID 轮询 API，直到处理完成。
5

下载视频输出

从提供的 URL 获取完成的图片生成口播或对口型视频。

​
使用限制：

  • 你最多可以有 10 个并发作业（包括排队请求）。
  • 预计排队时间：1–120 分钟，具体取决于系统负载。
  • 处理时间：约 10 分钟。
如果视频或照片包含多张脸，仅对检测到的最大脸进行对口型处理。

​
模型过期政策

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

​
规则

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

​
API 错误代码

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

​
作业错误代码

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