SubmitAvatarVideoJob
以人声音频或文本作为输入，渲染虚拟人视频
服务地址：
华东1（杭州）
输入参数
只看必填
InputConfig虚拟人任务输入参数
EditingConfig虚拟人任务配置信息
OutputConfig任务输出信息
Title任务标题
Description任务描述
UserData用户自定义设置
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 目前仅支持输入为文本或人声音频作为输入，音频仅支持 mp3 或 wav 格式。
  • 支持输出 mp4 和 webm 格式。当输出为 mp4 时，成片为带绿幕背景的视频，同时输出虚拟人的蒙版视频，供后续使用，推荐用这个方案。当输出为 webm 时，成片为带透明通道的 webm，可用于前端展示，由于 webm 编码问题，合成会慢一些。
  • 输出结果中包含人声的句子时间戳，供后续在剪辑中使用。

请求参数

字段名称字段详情
InputConfigstring

虚拟人任务输入参数。支持以文本、音频 OSS 文件、媒资作为输入。音频仅支持 mp3 或 wav 格式。展开详情

示例值:{"Text": "君不见黄河之水天上来，奔流到海不复回。君不见高堂明镜悲白发，朝如青丝暮成雪。"}
EditingConfigstring

虚拟人任务配置信息，支持设置虚拟人 id、人声、语速等信息

示例值:{"AvatarId":"yunqiao"}
OutputConfigstring

任务输出信息，支持设置输出地址

示例值:{"MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp4"}
Titlestring

任务标题，长度不超过 128 字节

示例值:测试标题
Descriptionstring

任务描述，长度不超过 128 字节

示例值:测试描述
UserDatastring

用户自定义设置，可传入客户业务信息，如业务方环境、任务信息，JSON 字符串格式。

示例值:{"user":"data","env":"prod"}

请求说明

InputConfig 示例：

输入为音频地址：

{
  "InputFile": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp3"
}

输入为文本：

{
  "Text": "君不见黄河之水天上来，奔流到海不复回。君不见高堂明镜悲白发，朝如青丝暮成雪。"
}

输入为 MediaId：

{
  "MediaId": "4aef0c80cc0071edbf92f6e7c44b6302"
}

EditingConfig 示例：

AvatarId：虚拟人形象 Id，必填 ，取值：数字人官方形象
Voice：发音人，仅输入为 Text 有效，选填，取值：智能语音效果示例
CustomizedVoice：个性化人声。如果需要使用通过人声克隆生成的个性化人声作为发音人，请使用此字段，而不是 Voice 字段
LoopMotion: 是否首尾同帧，如果设置此值为 true，则生成的数字人视频图像的首帧与尾帧相同，循环播放视频时人物形象的动作和表情不会有“跳变”现象，取值范围：{true, false}，默认值：false
SpeechRate：语速，仅当输入为文本类型有效，取值范围：-500～500，默认值：0
PitchRate：音调，仅当输入为文本类型有效，取值范围：-500～500，默认值：0
Volume：音量，仅当输入为文本类型有效，取值范围：0~100，默认值 50
BackgroundUrl：背景图，默认是绿幕，选填，仅支持 jpg、png 格式

{
  "AvatarId": "xinxin-marketing_standing", 
  "BackgroundUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.jpg",
  "Voice" : "zhichu",
  "LoopMotion": true,
  "SpeechRate": 100,
  "PitchRate": 10, 
  "Volume": 10 
}

OutputConfig 示例：

{
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp4
}

返回参数

字段名称字段详情
RequestIdstring

Id of the request

示例值:******11-DB8D-4A9A-875B-275798******
JobIdstring

智能任务 Id

示例值:****20b48fb04483915d4f2cd8ac****
MediaIdstring

成片媒资 id

示例值:******70dcc471edaf00e6f6f4******

返回说明

可以通过获取智能任务结果接口查询任务执行状态和任务结果，任务执行成功时接口返回结果示例如下.

{
	"RequestId": "2014D1A8-4143-164F-94B4-32B8F39B706D",
	"JobId": "d9367da8c7184ec7a3f24de530ac5b9a",
	"State": "Finished",
	"SmartJobInfo": {
		"Title": "default_title_2023-03-28T13:37:47Z",
		"EditingConfig": "null",
		"JobType": "AvatarVideo",
		"CreateTime": "2023-03-28T13:37:47Z",
		"ModifiedTime": "2023-03-28T13:37:47Z",
		"UserId": 1833202230108227,
		"outputConfig": {
			"mediaUrl": "https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4"
		}
	},
	"JobResult": {
		"MediaId": "4aef0c80cc0071edbf92f6e7c44b6302",
		"AiResult": "{\"outputVideoUrl\":\"https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4\",\"subtitleClips\":\"[{\\\"from\\\":0.0,\\\"to\\\":4.692,\\\"content\\\":\\\"君不见黄河之水天上来，奔流到海不复回。\\\"},{\\\"from\\\":4.692,\\\"to\\\":9.061,\\\"content\\\":\\\"君不见高堂明镜悲白发，朝如青丝暮成雪。\\\"}]\"}"
	}
}

其中，AiResult 格式如下：
outputVideoUrl 为输出成片地址，mp4 格式
subtitleClips 字幕句子时间戳

{
	"outputVideoUrl": "https://oushu-test-shanghai.oss-cn-shanghai.aliyuncs.com/avatar/222.mp4",
	"subtitleClips": "[{\"from\":0.0,\"to\":4.692,\"content\":\"君不见黄河之水天上来，奔流到海不复回。\"},{\"from\":4.692,\"to\":9.061,\"content\":\"君不见高堂明镜悲白发，朝如青丝暮成雪。\"}]"
}
变更历史
暂无变更历史