可按照域名和App级别配置播流审核服务。
接口说明
-
直播审核按照域名和 App 级别对于其中违规敏感内容进行识别审查,并通过回调的方式实时将违规内容通知到用户,用户可以对内容进行复审并进行相应处置。
-
目前仅部分直播中心支持直播智能审核,具体支持该功能的直播中心,请参见服务地域。
QPS 限制
本接口的单用户 QPS 限制为 30 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:AddLiveSnapshotDetectPornConfig |
create |
*Domain
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DomainName |
string |
是 |
主播流域名。 |
example.com |
| AppName |
string |
是 |
播流所属应用名称。 AppName 名称与推流地址中的 AppName 名称对应,模板才能生效。不超过 255 字符,支持数字、大小写字母、短横线(-)、下划线(_),短横线、下划线不能位于首位。也支持取值为单个星号(*)字符,即可匹配所有 AppName。 |
testApp |
| OssEndpoint |
string |
是 |
OSS 存储 Endpoint 名称。 审核完成后,您可以根据审核回调信息,在 OSS 控制台查找指定的审核内容。OSS Endpoint 需要提前创建,创建方法请参考配置审核 。 |
cn-oss-****.aliyuncs.com |
| OssBucket |
string |
是 |
OSS 存储 Bucket 名称。 审核完成后,您可以根据审核回调信息,在 OSS 控制台查找指定的审核内容。OSS Bucket 需要提前创建,创建方法请参考配置审核 。 |
livebucket |
| OssObject |
string |
否 |
保存涉黄涉政等违规图片名称。 |
record/{AppName}/{StreamName}/{Sequence}.jpg |
| Interval |
integer |
否 |
采样间隔。取值范围:5~3600。单位:秒。 |
10 |
| Scene |
array |
否 |
检测场景列表。 |
live |
|
string |
否 |
检测场景。取值:
|
live |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
16A96B9A-F203-4EC5-8E43-CB92E68F**** |
示例
正常返回示例
JSON格式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}
异常返回示例
JSON格式
{
"Code":"InternalError",
"HostId":"live.aliyuncs.com",
"Message":"The request processing has failed due to some unknown error.",
"RequestId":"6EBD1AC4-C34D-4AE1-963E-B688A228BE31"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidOssEndpoint.Malformed | Specified parameter OssEndpoint is not valid. | |
| 400 | InvalidOssBucket.Malformed | Specified parameter OssBucket is not valid. | OSSBucket参数错误,请您确认该OSS BUCKET参数是否正确。 |
| 400 | InvalidOssObject.Malformed | Specified parameter OssObject is not valid. | |
| 400 | InvalidOssBucket.NotFound | The parameter OssBucket does not exist. | |
| 400 | InvalidScenes | Specified parameter Scene is not valid. | |
| 400 | ConfigAlreadyExists | Config has already exist. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。