AddLiveAIProduceRules - 添加实时字幕规则_视频直播(LIVE)-阿里云帮助中心

添加字幕规则。

接口说明

调用 AddLiveAISubtitle 接口添加字幕模板后，可使用本接口添加字幕规则。
播放字幕流需要在播放地址的 StreamName 后加_{字幕模板名称}：
- RTMP：rtmp://example.aliyundoc.com/app/stream_{字幕模板名称}?auth_key={鉴权串}
- FLV：http://example.aliyundoc.com/app/stream_{字幕模板名称}.flv?auth_key={鉴权串}
- M3U8：http://example.aliyundoc.com/app/stream_{字幕模板名称}.m3u8?auth_key={鉴权串}

重要

当前实时字幕功能处于邀测阶段，单个用户最多可添加 300 个字幕模板。

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

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

操作

访问级别

资源类型

条件关键字

关联操作

live:AddLiveAIProduceRules

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

无

名称	类型	必填	描述	示例值
RegionId	string	否	地域 id。	cn-shanghai
Domain	string	是	主播流域名。	demo.aliyundoc.com
App	string	是	直播流应用名称。不超过 256 字符，支持数字、大小写字母、短划线（-）、下划线（_）AppName 名称与推流地址中的 AppName 名称对应，模板才能生效。	AppName
Suffix	string	否	后缀匹配	test01
SubtitleName	string	否	字幕模板名称	sub01
StudioName	string	否	虚拟背景模板名称	sub02
IsLazy	boolean	否	拉流触发。取值： true：拉流时启动字幕，若 5 分钟内没有拉流则会断掉字幕，后续再有拉流才会启动。 false：只要有推流就启动字幕，与是否有拉流无关。	true
LiveTemplate	string	是	字幕输出规格，取值：横屏流畅 360P 640x360：`lp_ld` 竖屏流畅 360P 360x640：`lp_ld_v` 横屏标清 480P 854x480：`lp_sd` 竖屏标清 480P 480x854：`lp_sd_v` 横屏高清 720P 1280x720：`lp_hd` 竖屏高清 720P 720x1280：`lp_hd_v` 横屏超清 1080P 1920x1080：`lp_ud` 竖屏超清 1080P 1080x1920：`lp_ud_v`	lp_ld
Description	string	否	字幕规则描述。可包含中英文、数字、字符，不超过 128 位。	live AI subtitle template

正常返回示例

JSON格式

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

HTTP status code	错误码	错误信息	描述
400	MissingParameter	%s.	参数缺失
400	InvalidParameter	%s.	参数错误

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

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