天翼云智能视图服务API

1.创建AI应用

接口功能介绍

本接口用于创建AI应用。

接口约束

无

URI

POST /ai/apps

路径参数
无

Query参数
无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例
Authorization	是	String	认证信息。	CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-Type	是	String	互联网媒体类型。	application/json;charset=utf-8
Host	是	String	主机。	vssapi.ctyun.cn
Version	是	String	版本。	2021-11-25
Timestamp	是	String	时间戳。	1689643309

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
AppName	是	String	应用名称，长度为1~10个字符。	testApp
AlgorithmsId	是	Integer	AI算法类型ID，可通过查询AI算法列表API获取。	2
AnalyseType	是	String	分析频率，分钟级AI-100；秒级AI-200。	AI-100
Confidence	是	Double	置信度，取值范围为0~1。	0.6
AlgorithmMetadata	否	Object	算法的自定义配置项，具体可参考表AlgorithmMetadata的参数说明。		AlgorithmMetadata
OperTimeSlot	否	Array of Objects	AI应用生效时间段，最多包含五组时间段。默认为全天（00:00:00-23:59:59）。		OperTimeSlot
AlertConfig	否	Object	告警配置。		AlertConfig
Description	否	String	应用描述。	应用描述

表 AlgorithmMetadata

参数	是否必填	参数类型	说明	示例
HelmetReflectiveType	否	Array of Strings	安全帽反光服检测，AlgorithmsId=4（helmet:未带安全帽告警，reflective:未穿反光服报警）。当AI算法类型为安全帽反光服检测时，该字段必选。	["helmet","reflective"]
PedThreshold	否	String	行人检测，AlgorithmsId=5（人员数量阈值），当AI算法类型为行人检测时，该字段必选。	22
FaceDbName	否	String	人脸库ID，AlgorithmsId=16/34，当AI算法类型为入侵检测或人脸识别时，该字段必选。	1080062
TimeSlide	否	String	时间窗口，AlgorithmsId=22，当AI算法类型为车辆统计时，该字段必选。取值范围为1~24的整数。	10
VehiclesThreshold	否	String	车辆数量阈值，AlgorithmsId=22，当AI算法类型为车辆统计时，该字段必选。	10
PvTime	否	String	车辆违停检测，AlgorithmsId=24（临停时间），当AI算法类型为车辆违停检测时，该字段必选。单位为分钟。	22
JamThreshold	否	String	车辆拥堵检测，AlgorithmsId=25（拥堵车辆阈值），当AI算法类型为车辆拥堵检测，该字段必选。	56
CrowdThreShold	否	String	人群感应检测，AlgorithmsId=26（人员数量阈值），当AI算法类型为人群感应检测时，该字段必选。	21
OffDutyThreShold	否	String	实时在岗检测，AlgorithmsId=27（人脱岗超时时间），当AI算法类型为实时在岗检测时，该字段必选。单位为分钟。	14
SleepOnDutyThreShold	否	String	实时在岗检测，AlgorithmsId=27（睡岗超时时间），当AI算法类型为实时在岗检测时，该字段必选。单位为分钟。	12
LingerInterval	否	String	人员徘徊检测，AlgorithmsId=28，当AI算法类型为人员徘徊检测时，该字段必选。单位为分钟。	10
CityGovType	否	Array of Strings	城市治理，AlgorithmsId=37. （店外经营，游摊小贩，占道经营乱堆物料，户外广告，打包垃圾，暴露垃圾，沿街晾晒，违规撑伞，地桩地锁，绿化损坏，道路破损，垃圾箱未加盖，垃圾箱满溢，气拱门，横幅识别，井盖异常），当AI算法类型为城市治理时，该字段必选。	["dianwai","youtan","zhandao","wuliao","guanggao","dabaolaji","baolulaji","liangshai","chengsan","disuo","lvhuasunhuai","daoluposun","weijiagai","manyi","qimogongmeng","banner","cover"]

表 OperTimeSlot

参数	是否必填	参数类型	说明	示例	下级对象
StartTime	否	String	开始时间。格式为"hh:mm:ss"，且StartTime必须小于EndTime。默认值为"00:00:00"。	08:40:00
EndTime	否	String	结束时间。格式为"hh:mm:ss"，且StartTime必须小于EndTime。默认值为"23:59:59"。	09:40:00

表 AlertConfig

参数	是否必填	参数类型	说明	示例
AlertPeriod	否	String	告警周期，检测告警信息的时间区段，默认0秒。	30
AlertTriggerThreshold	否	String	告警数量阈值，检测告警信息的数量阈值，默认0个。	5
AlertSilencePeriod	否	String	静默时间。静默时间内，不产生任何的AI告警信息，告警周期内触发告警之后即进入静默期，待达到静默时间之后，重新进行新一轮的告警判断，默认0秒。	10

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	响应状态码。	200
error	String	错误码，执行成功时，不返回该字段。	VSS_0001
message	String	响应信息。	请求成功
requestId	String	请求ID。	362d4e78556b47129182d0881fade86b
returnObj	Object	响应数据。		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
AppId	String	AI应用ID。	32388487739092996
RequestId	String	请求ID。	362d4e78556b47129182d0881fade86b

请求示例

请求url

POST '/ai/apps'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1689643309"
}

请求体body

{
    "AppName":"1113",
    "AnalyseType":"AI-100",
    "Confidence":0.7,
    "AlgorithmsId":2
}

响应示例

{
    "statusCode": 200,
    "message": "请求成功",
    "requestId": "c757803c20ab4fe4b7790950f7e03d26",
    "returnObj": {
        "RequestId": "c757803c20ab4fe4b7790950f7e03d26",
        "AppId": "583"
    }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。

创建AI应用

最近更新时间：2026-03-19 18:16:28

天翼云智能视图服务API

1.创建AI应用

接口功能介绍

接口约束

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码