找不到 API ? 点击 反馈吧
- 数字人实例
- 消息
- 数字人视频合成
- 数字人形象管理
- 端渲染
- 控制台管理
- 其他
SubmitTextTo2DAvatarVideoTask
提交根据一段文本离线生成2D数字人视频任务,该接口会立即返回一个TaskUuid作为本次提交任务的唯一id,后续可以根据TaskUuid调用查询和取消任务接口
服务地址:
华北3(张家口)
参数配置
高级配置
输入参数
只看必填
注意事项
TenantId租户ID
App开发者应用信息
AppIdApp ID
Title提交的视频合成的任务标题
Text合成文本
VideoInfo视频配置
IsAlpha是否需要透明通道
请选择布尔值
AlphaFormat透明通道格式
IsSubtitles是否需要字幕
请选择布尔值
SubtitleEmbedded是否将字幕合并到视频中
请选择布尔值
BackgroundImageUrl有效可访问的url背景图片地址;
Resolution生成的视频分辨率
SubtitleStyle字幕样式
Name字体名称
Color字体颜色
OutlineColor描边颜色
Y字幕y轴位置
Size字体大小
AudioInfo音频相关配置
VoiceTTS播报发音人code
SpeechRateTTS播报声音语速
VolumeTTS播报声音音量
PitchRateTTS播报声音语调
SampleRate输出音频采样率(单位: Hz)
AvatarInfo数字人形象相关配置
Code数字人形象code
X数字人图层相对于画面左上角横轴像素偏移量
Y数字人图层相对于画面左上角纵轴像素偏移量
Width数字人图层宽度
Height数字人图层高度
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.
接口说明
提交根据一段文本离线生成 2D 数字人视频任务,该接口会立即返回一个 TaskUuid 作为本次提交任务的唯一 id,后续可以根据 TaskUuid 调用查询视频合成任务详情接口查询对应的任务的状态,当任务状态为已完成时可以获取到对应视频的下载地址,进行视频下载。在任务状态为未开始情况下,也可以通过 TaskUuid 调用取消视频合成任务接口,取消该任务。
说明
参考 2D 数字人视频合成使用指南了解完整的 2D 视频合成接入流程。
请求参数
字段名称 | 字段详情 |
---|---|
TenantIdinteger<int64> | 租户 ID,从虚拟数字人开放平台中获取的 TenantId 注意
该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。 示例值:xxxxx |
Appobject | 开发者应用信息,代表一个业务配置 |
Titlestring | 提交的视频合成的任务标题,最长不超过 64 个字符 示例值:这是一个示例标题 |
Textstring | 合成文本, 最长不超过 1000 个字符。支持 SSML 指定 TTS 的多音字发音、停顿、特殊读法等,可参考: 2D 数字人视频合成使用指南。 示例值:这是一个示例文本参考取值来源: SendText |
VideoInfoobject | 视频配置 |
AudioInfoobject | 音频相关配置,不传则使用资产中配置的默认值。 |
AvatarInfoobject | 数字人形象相关配置。 |
Callbackboolean | 本次视频合成任务是否需要事件回调,默认 false 不回调。平台支持在任务开始和任务结束时进行事件回调,具体可参考文档:数字人回调事件通知。 示例值:false |
CallbackParamsstring | 回调时需要透传的一些参数,json 格式字符串,callback=false 时不生效。 示例值:{
"xxx": "xxx"
} |
ExtParamsstring | 一些扩展参数。 示例值:{
"xxx": "xxx"
} |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID 示例值:13E0445E-CA7F-5DD3-9B0F-D4B39E0180F7 |
Successboolean | 调用是否成功。 示例值:false |
Codestring | 错误码 示例值:-10000000 |
Messagestring | 错误消息 示例值:这个一次错误消息。 |
Dataobject | 调用结果数据 |
返回说明
TaskUuid 是该任务的唯一标识,请务必保存好。