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