SubmitCosyVoiceCustomizedVoiceJob - 提交CosyVoice版本人声克隆训练任务-阿里云帮助中心

接口说明

在训练期间，您可以通过调用 GetCustomizedVoiceJob - 查询人声克隆任务接口来获取当前任务是否完成或训练状态等信息。
该接口为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果可通过查询人声克隆任务主动查询任务状态。
注意每个账号每个区域支持最多复刻 30 个音色，暂时不支持提升额度。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitCosyVoiceCustomizedVoiceJob

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
VoiceName	string	否	声音名字，不超过 32 个字符。	小专
Gender	string	否	性别，取值范围： female：女性 male：男性	female
Audios	string	否	训练声音素材媒资 Id，当前仅支持对一个音频素材进行训练。	**571c704445f9a0ee011406c2**
DemoAudioMediaURL	string	否	示例音频输出地址如果传入此参数，则会在训练成功后在此参数表示的 OSS 地址生成示例音频重要需要是您账号下合法的 OSS 公网地址	https://your-bucket.oss-cn-shanghai.aliyuncs.com/demo.MP3
Model	string	否	声音克隆模型。包含： cosyvoice-v3-plus cosyvoice-v3-flash cosyvoice-v3.5-plus cosyvoice-v3.5-flash	cosyvoice-v3-plus

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	C0C02296-113C-5838-8FE9-8F3A32998DDC
Success	boolean	请求是否成功，取值： true：成功 false：失败。	true
Data	object	返回结果
JobId	string	人声克隆任务 Id	bfb786c639894f4d80648792021****
VoiceId	string	音色 Id	Voice-l*****

示例

正常返回示例

JSON格式

{
  "RequestId": "C0C02296-113C-5838-8FE9-8F3A32998DDC",
  "Success": true,
  "Data": {
    "JobId": "bfb786c639894f4d80648792021****",
    "VoiceId": "Voice-l*****"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。