AddLiveAISubtitle - 添加直播字幕模板_视频直播(LIVE)-阿里云帮助中心

调用AddLiveAISubtitle添加字幕模板。

接口说明

使用说明

本接口支持添加直播字幕模板配置，模板配置支持描述字幕内容、布局等信息。
添加字幕模板后，您还需要调用 AddLiveAIProduceRules 接口添加字幕规则，重新推流后，播流中才能带字幕。
实时字幕仅支持北京、上海、新加坡、印尼、沙特区域。

重要

当前实时字幕功能处于公测阶段，单个用户最多可添加 300 个字幕模板。暂时免费使用，公测结束后将正常收费，具体时间另行通知。

QPS 限制

本接口的单用户 QPS 限制为 60 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

live:AddLiveAISubtitle

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID。	cn-shanghai
SubtitleName	string	是	字幕模板名称，仅支持数字、大小写字母或短横线-，短横线不和位于首位。	sub01
SrcLanguage	string	是	源语言，取值：英文：en-US 中文：zh-CN 俄文：ru-RU	zh-CN
DstLanguage	string	否	翻译目标语言，取值：英文：en-US 中文：zh-CN 西班牙文：es-ES 俄文：ru-RU	zh-CN
FontColor	string	否	字体颜色，RGBA 值。	0xFFFFFF
FontName	string	否	字体，取值： KaiTi-楷体，默认 AlibabaPuHuiTi-Regular-阿里巴巴普惠体-常规 AlibabaPuHuiTi-Bold-阿里巴巴普惠体-粗体 AlibabaPuHuiTi-Light-阿里巴巴普惠体-细体 NotoSansHans-Regular-思源黑体-常规 NotoSansHans-Bold-思源黑体-粗体 NotoSansHans-Light-思源黑体-细体	KaiTi
BgColor	string	否	字幕背景颜色，RGBA 值。	0xFF0000
PositionNormalized	array	是	字幕位置信息
	number	否	字幕位置。以屏幕左下角为起点的 x,y 轴。说明 x,y 需要进行归一化计算。实际数值需要乘以画面高度。如画面高度为 720p 设置的 PositionNormalized 为[0.1,0.5] ，则字幕的实际位置是 x 轴为 72，y 轴为 360。	[0.32,0.27]
ShowSourceLan	boolean	否	是否显示源语言，ShowSourceLan 默认为 false。	true
MaxLines	integer	否	显示行数。	2
WordPerLine	integer	是	每行显示字数，取值范围：支持输入【1,500】内的整数。	20
FontSizeNormalized	number	是	字体尺寸，取值范围：【0,1】	0.037
BorderWidthNormalized	number	否	字体粗细，取值范围：【0,1】	0.05
BgWidthNormalized	number	否	字幕背景尺寸，取值范围：【0,1】	0.09
CopyFrom	string	否	复制的字幕模板，传值 SubtitleName	sub01
Description	string	否	自定义字幕描述信息。可包含中英文、数字、字符，不超过 128 位。	live AI subtitle template
Width	string	否	预览画面宽度，单位：px	1280
Height	string	否	预览画面高度，单位：px 预览画面宽度 x 高度仅支持以下规格：横屏流畅 360P 640x360 竖屏流畅 360P 360x640 横屏标清 480P 854x480 竖屏标清 480P 480x854 横屏高清 720P 1280x720 竖屏高清 720P 720x1280 横屏超清 1080P 1920x1080 竖屏超清 1080P 1080x1920	720

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	5c6a2a0df228-4a64-af62-20e91b96****
SubtitleId	string	字幕模板 ID。	445409ec-7eaa-461d-8f29-4bec2eb9****

示例

正常返回示例

JSON格式

{
  "RequestId": "5c6a2a0df228-4a64-af62-20e91b96****",
  "SubtitleId": "445409ec-7eaa-461d-8f29-4bec2eb9****"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	%s.	参数错误
400	MissingParameter	%s.	参数缺失
400	InvalidParameter.Malformed	There are invalid parameters: %s.	存在无效参数：%s。

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

变更历史

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