调用CreateBroadcastVideoFromTemplate使用播报模板合成视频-虚拟数字人-阿里云-虚拟数字人(DVH)-阿里云帮助中心

基于播报模板合成视频。

接口说明

查询指定实例下的活跃会话信息。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

lingmou:CreateBroadcastVideoFromTemplate

create

*全部资源

*

无

请求语法

POST /api/v1/amp/customer/broadcast/video/createFromTemplate HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体。
templateId	string	否	播报模板 Id。调用列举播报模板接口获取 id 参数值。	BS1b2WNnRMu4ouRzT4clY9Jhg
name	string	否	视频名称。	播报视频合成测试
videoOptions	object	否	视频输出选项。
resolution	string	否	分辨率，默认`720p`。取值范围： 720p 1080p 2160p	720p
fps	integer	否	帧率，默认`30`fps。取值范围： 15 30	30
watermark	boolean	否	是否带水印，默认`True`。 True：是 False：否	True
languageHints	array	否	指定视频合成的目标语言，提升合成效果。当数字、缩写、符号等朗读方式或者小语种合成效果不符合预期时使用，例如：数字朗读方式不符合预期，“hello, this is 110”读成“hello, this is one one zero”而非“hello, this is 幺幺零” 符号朗读不准确，“@”读成“艾特”而非“at” 小语种合成效果差，合成不自然取值范围： zh：中文 en：英文 fr：法语 de：德语 ja：日语 ko：韩语 ru：俄语 pt：葡萄牙语 th：泰语 id：印尼语 vi：越南语注意：此参数为数组，但当前版本仅处理第一个元素，因此建议只传入一个值。
	string	否	目标语言	en
mode	string	否	导出模式，默认全部（ALL）。取值范围： ALL: 导出全部场景元素，包含背景，数字人，贴图，字幕等图层，输出视频格式为 mp4。 ONLY_AVATAR: 去除背景、贴图、字幕等，仅保留数字人通道，输出视频格式为 webm（包含透明通道）。注意：仅对透明背景数字人生效，实景数字人会提示错误。	ALL
variables	array	否	播报模板中的动态变量列表，可以用于替换图片、文本、数字人（全局）、音色（全局）、音频。
	TemplateVariable	否	播报模板动态变量。

返回参数

名称	类型	描述	示例值
	object	Result
data	BroadcastVideo	播报视频。	{"sessionId": "20250311-41523E3C-1D27-5844-8EEF-194E4714096B", "mainAccountId": 1234567, "createdAt": 1755680457}
success	boolean	请求是否成功。	True
code	string	状态码。	SUCCESS
message	string	状态码描述。	success
requestId	string	请求 ID。	0EC3BA89-13F5-5766-A0BA-85096092A032
httpStatusCode	integer	http 响应码。	200

示例

正常返回示例

JSON格式

{
  "data": {
    "id": "M1k3So6n9IlrDV69sr3jDa3g",
    "createTime": "2025-11-28T13:40:33",
    "modifiedTime": "2025-11-28T13:41:31",
    "name": "播报视频合成测试",
    "status": "SUCCESS",
    "coverURL": "https://online-avatar-property.oss-cn-beijing.aliyuncs.com/aigc_material/OUTPUT_BROADCAST_SHORT_VIDEO/Mt.CQEYXYQW4MQU2/cover.jpg",
    "videoURL": "https://online-avatar-property.oss-cn-beijing.aliyuncs.com/aigc_material/OUTPUT_BROADCAST_SHORT_VIDEO/Mt.CQEYXYQW4MQU2/result.mp4",
    "captionURL": "https://online-avatar-property.oss-cn-beijing.aliyuncs.com/aigc_material/OUTPUT_BROADCAST_SHORT_VIDEO/Mt.CQEYXYQW4MQU2/result.srt",
    "alignmentFileURL": "https://online-avatar-property.oss-cn-beijing.aliyuncs.com/aigc_material/OUTPUT_BROADCAST_SHORT_VIDEO/Mt.CQEYXYQW4MQU2/alignment.json"
  },
  "success": true,
  "code": "SUCCESS",
  "message": "success",
  "requestId": "0EC3BA89-13F5-5766-A0BA-85096092A032",
  "httpStatusCode": 200
}

错误码

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

变更历史

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