找不到 API ? 点击 反馈吧
- 数字人实例
- 消息
- 数字人视频合成
- 数字人形象管理
- 端渲染
- 控制台管理
- 其他
SubmitAudioTo2DAvatarVideoTask
提交根据一段wav音频文件生成2D数字人视频任务，该接口会立即返回一个TaskUuid作为本次提交任务的唯一id，后续可以根据TaskUuid调用查询和取消任务接口
服务地址：
华北3（张家口）
参数配置
高级配置
输入参数
只看必填
注意事项
TenantId租户ID
AppApp信息
AppIdApp ID
Title提交的视频合成的任务标题
VideoInfo视频配置
IsAlpha是否需要透明通道
请选择布尔值
BackgroundImageUrl有效可访问的url背景图片地址；
Resolution生成的视频分辨率
AlphaFormat透明通道格式
AvatarInfo数字人形象相关配置
Code数字人形象code
X数字人图层相对于画面左上角横轴像素偏移量
Y数字人图层相对于画面左上角纵轴像素偏移量
Width数字人图层宽度
Height数字人图层高度
AudioInfo音频相关配置
SampleRate输出音频采样率（单位: Hz）
Url音频的地址url
Callback本次视频合成任务是否需要事件回调
请选择布尔值
CallbackParams回调时需要透传的一些参数
ExtParams一些扩展参数
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
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 IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
提交根据一段 wav 音频离线生成 2D 数字人视频任务，该接口会立即返回一个 TaskUuid 作为本次提交任务的唯一 id，后续可以根据 TaskUuid 调用查询视频合成任务详情接口查询对应的任务的状态，当任务状态为已完成时可以获取到对应视频的下载地址，进行视频下载。在任务状态为未开始情况下，也可以通过 TaskUuid 调用取消视频合成任务接口，取消该任务。
说明
参考 2D 数字人视频合成使用指南了解完整的 2D 视频合成接入流程。
请求参数
| 字段名称 | 字段详情 |
|---|---|
TenantIdinteger<int64> | 租户 ID，从虚拟数字人开放平台中获取的 TenantId 注意
该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。 示例值:20516 |
Appobject | App 信息，代表一个业务配置 |
Titlestring | 提交的视频合成的任务标题，最长不超过 32 个字符 示例值:常吃的皮蛋一般是由哪一种蛋加工而成的？ |
VideoInfoobject | 视频配置 |
AvatarInfoobject | 数字人形象相关配置。 |
AudioInfoobject | 音频相关配置。 |
Urlstring | 音频的地址 url，要求音频时长小于 30 分钟，采样率 16K，单声道，单采样点位深 16bit 示例值:可访问的公网url地址 |
Callbackboolean | 本次视频合成任务是否需要事件回调，默认 false 不回调。平台支持在任务开始和任务结束时进行事件回调，具体可参考文档：数字人回调事件通知。 示例值:false |
CallbackParamsstring | 回调时需要透传的一些参数，json 格式字符串，callback=false 时不生效。 示例值:{
"xxx": "xxx"
} |
ExtParamsstring | 一些扩展参数。 示例值:{"xxx": "xxx"} |
返回参数
| 字段名称 | 字段详情 |
|---|---|
RequestIdstring | 请求 ID 示例值:4C8BF3A5-948F-1F89-AACD-D18DEF52D1XX |
Codestring | 错误码 示例值:10050008 |
Messagestring | 错误消息 示例值:这个一个错误消息。 |
Successboolean | 是否成功 示例值:true |
Dataobject | 调用结果数据 |
变更历史
| 变更时间 | 变更内容概要 | 操作 | |
|---|---|---|---|
| 2024-01-08 | 新增请求参数AudioInfo | ||
| 2023-12-14 | 变更请求参数AvatarInfo | ||
| 2023-08-01 | 变更请求参数VideoInfo 变更返回参数 | ||
| 2023-06-25 | 新增请求参数Callback 新增请求参数CallbackParams 新增请求参数ExtParams |