GB/T 46351-2025 人工智能 多算法管理技术要求

　　ICS 35.240 CCS L 70

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 46351—2025

　　人工智能 多算法管理技术要求

　　Artificialintelligence—Multi-algorithm managementtechnicalrequirements

　　2025-10-05发布 2025-10-05实施

　　国家市场监督管理总局国家标准化管理委员会

　　

　　发

　　

　　布

　　GB/T 46351—2025

　　目 次

　　前言 Ⅲ

　　1 范围 1

　　2 规范性引用文件 1

　　3 术语和定义 1

　　4 缩略语 1

　　5 多算法管理系统框架 1

　　6 算法仓库 2

　　7 算法调度服务 2

　　8 算法包 3

　　8. 1 算法包构成 3

　　8. 2 算法包目录 3

　　8. 3 算法属性信息 4

　　8. 4 算法技术信息 5

　　9 多算法管理系统的接口要求 6

　　9. 1 接口概述 6

　　9. 2 资源查询 6

　　9. 3 算法分发 8

　　9. 4 实例启动 10

　　9. 5 实例停止 11

　　9. 6 算法卸载 11

　　9. 7 任务派发 12

　　9. 8 任务查询 15

　　9. 9 任务修改 18

　　9. 10 状态查询 20

　　9. 11 任务删除 22

　　9. 12 任务结果 23

　　9. 13 算法检索 25

　　9. 14 算法下载 27

　　附录 A (资料性) 算法封装描述示例说明 28

　　A. 1 算法包信息示例(packageinfo. xml) 28

　　A. 2 算法属性信息描述示例(managementinfo.json) 28

　　A. 3 算法技术信息描述示例(technicalinfo.json) 30

　　附录 B (资料性) 参数 33

　　Ⅰ

　　GB/T 46351—2025

　　B. 1 通用参数 33

　　B. 2 检测区域 33

　　B. 3 屏蔽区域 33

　　B. 4 区域规则 34

　　B. 5 目标数量过滤参数 34

　　B. 6 目标尺寸过滤参数 35

　　B. 7 分析参数构成及结构 35

　　附录 C (资料性) 接口错误码 37

　　Ⅱ

　　GB/T 46351—2025

　　前 言

　　本文件按照 GB/T 1. 1—2020《标准化工作导则 第 1部分 :标准化文件的结构和起草规则》的规定起草 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别专利的责任 。

　　本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归 口 。

　　本文件起草单位 :杭州海康威视数字技术股份有限公司 、中国电子技术标准化研究院 、四川大学华西医院 、西北工业大学 、哈尔滨工业大学(深圳) 、中国科学院自动化研究所 、北京交通大学 、北京航空航天大学 、浙江大华技术股份有限公司 、赛飞特工程技术集团有限公司 、昆仑数智科技有限责任公司 、中国石油天然气股份有限公司长庆油田分公司 、国能信息技术有限公司 、北京中数睿智科技有限公司 、浪潮软件科技有限公司 、中移(杭州)信息技术有限公司 、杭州趣链科技有限公司 、杭州高新区(滨江) 区块链与数据安全研究院 、广电运通集团股份有限公司 、中电科大数据研究院有限公司 、中电金信软件有限公司 、万达信息股份有限公司 、上海计算机软件技术开发中心 、上海人工智能研究院有限公司 、深圳市腾讯计算机系统有限公司 、浪潮电子信息产业股份有限公司 、深圳思谋信息科技有限公司 、中国移动通信集团有限公司 、中国电信股份有限公司重庆分公司 、北京安声科技有限公司 。

　　本文件主要起草人 : 陈锋 、钱 晓 东 、马 珊 珊 、徐 洋 、曹 文 檩 、赵 俊 钰 、聂 简 荻 、林 泉 宇 、许 佳 麒 、殷 晋 、沈芷月 、王兆俊 、张艳宁 、吴建龙 、聂礼强 、朱贵波 、贾一君 、陶仁帅 、马宇晴 、孔维生 、李迪 、王娟 、王小宏 、梁倩 、马同森 、张天霖 、谢开浪 、李照川 、王珂琛 、张晴 、浦贵阳 、王仲威 、杜静漪 、魏遵博 、胡文魁 、蔡惠民 、吕逸良 、张敬谊 、陈敏刚 、宋海涛 、王资凯 、黄超 、鲁璐 、刘枢 、秦日臻 、赖苏 、王晨子 、刘益帆 、王松 。

　　Ⅲ

　　GB/T 46351—2025

　　人工智能 多算法管理技术要求

　　1 范围

　　本文件确立了多算法管理系统框架 ,规定了算法仓库 、算法调度服务 、算法包 、多算法管理系统接 口的技术要求 。

　　本文件适用于多算法管理系统的设计 、研究 、开发 、实施 、部署 、验收和评估 。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中 , 注 日期的引用文件 ,仅该日期对应的版本适用于本文件 ;不注日期的引用文件 ,其最新版本(包括所有的修改单) 适用于本文件 。

　　GB/T 41867—2022 信息技术 人工智能 术语

　　3 术语和定义

　　GB/T 41867—2022界定的以及下列术语和定义适用于本文件 。

　　3. 1

　　多算法管理 multi-algorithm management

　　对不同厂商 、不同功能 、不同平台 、不同版本的算法进行管理 。

　　3.2

　　算法模型 algorithm model

　　用特定的机器学习算法在数据集上训练而构建的模型 ,包含模型结构和参数 。

　　3.3

　　算法任务 algorithm task

　　应用系统使用智能算法对数据进行处理和分析的过程 。

　　注 : 以图像为例 ,算法任务包括图片识别 、图片分类 、目标检测 、图片检索等 。

　　4 缩略语

　　下列缩略语适用于本文件 。

　　CPU : 中央处理器(CentralProcessing Unit)

　　GPU : 图形处理器(Graphics Processing Unit)

　　HTTP:超文本传输协议(HyperTextTransferProtocol)

　　JSON:JavaScript对象标记语言(JavaScriptObjectNotation)

　　SoC:系统级芯片(System on Chip)

　　5 多算法管理系统框架

　　多算法管理系统是具备算法管理(增 、删 、改 、查)和算法调度的软件系统 , 由算法仓库和算法调度服

　　1

　　GB/T 46351—2025

　　务构成 。

　　多算法管理系统框架见图 1。

　　图 1 多算法管理系统框架示意图

　　6 算法仓库

　　算法仓库统一管理多算法 ,为算法复用 、调度提供基础 。通过制定完备的算法封装描述规范 ,算法仓库应具备对算法名称 、类型 、功能 、技术参数 、应用场景 、运行环境等多方面的特征进行描述和管理的能力 ,从而能够在算法部署 、编排 、调度过程中提供相适应的技术环境或调度参数 ,与算法调度服务相配合 ,实现算法的统一管理和按需调度 。

　　算法仓库作为算法管理的软件 ,应具备算法导入 、算法存储 、算法检索 、算法删除 、算法下载和算法运营的功能 ,这些功能符合如下要求 :

　　a) 算法导入功能应对导入的算法包进行校验 ,不应导入校验不通过的算法包 ;

　　b) 算法存储功能应能存储所导入的算法包 ;

　　c) 算法检索功能应提供算法检索接 口 ,供应用系统检索算法并配置使用 ;

　　d) 算法删除功能应支持删除算法仓库中不再使用的算法包 ;

　　e) 算法下载功能应提供算法包下载接 口 ,供计算设备下载对应的算法包 ;

　　f) 算法运营功能应支持根据使用效果对算法打标签 ,对算法进行上下架操作 。

　　7 算法调度服务

　　算法调度服务接收应用系统的算法任务 ,根据算法任务的要求和系统中计算设备的运行情况查询可用资源 ,选择合适的算法并分发到匹配的计算设备上 , 同时将计算设备反馈的任务结果推送到应用系统 。算法调度服务根据任务状态启停算法实例 ,获取计算设备中的算法任务执行状态对算法任务进行监控 ,人工或根据预设策略处理异常任务 ,提高系统可用性 。

　　算法调度服务具备算力管理 、策略管理 、实例管理 、任务管理和状态监控的功能 :

　　a) 算力管理功能应支持调用计算设备的资源查询接 口 ,查询计算设备的算力资源和使用情况 ,对

　　2

　　GB/T 46351—2025

　　计算设备的算力进行统一管理 ,实现算力调度 ;

　　b) 策略管理功能应提供调度策略配置 、调度成效展示等功能 ,实现算力的灵活调度和系统算力资源的最大化利用 ,常用的策略有闲时分析策略 、优先级策略 、强制策略等 ;

　　c) 任务管理功能应向应用系统提供算法任务创建 、算法任务执行状态和结果查询 、算法删除的接口 ,应用系统通过算法调度服务投递算法任务 ,查询任务执行状态和结果 ,删除算法任务 、卸载算法释放算力和存储资源 ;

　　d) 实例管理功能应向应用系统提供实例启动 、实例停止的接 口 ,应用系统通过算法调度服务控制实例运行状态 ;

　　e) 状态监控功能应支持调用计算设备的状态查询接口对计算设备的算法和任务执行状态进行监控 ,对异常情况预警 ,及时告知维护人员介入排查 。

　　8 算法包

　　8. 1 算法包构成

　　算法包是算法的成果物实体 ,用于算法的交付 、分发 、部署 , 由算法模型 、算法形式化描述文件以及算法程序构成(见图 2) :

　　a) 算法在全生命周期内 , 因算法程序更新 、算法模型优化 、算法形式化描述文件调整等原因可迭代更新多个不同的版本 ;

　　b) 算法程序是算法包的可选组成部分 ,是根据特定的人工智能处理方法 ,适配不同芯片平台 、不同操作系统运行的软件程序 ,根据程序的功能差异 ,可分为算法库和其他程序文件(如解码程序文件) ;

　　c) 算法模型是利用一定数量的训练数据 ,并基于机器学习算法训练调优生成 ,用于推理计算 ;

　　d) 算法形式化描述文件是计算机系统识别和管理算法程序过程中用于描述内在属性和外部关联关系 ,算法形式化描述文件包括算法属性信息描述文件 、算法技术信息描述文件以及封 面 信息 、算法应用场景等附件资料 ;

　　e) 一个算法包只含一种计算平台的算法模型 、算法程序和算法形式化描述文件 。

　　图 2 算法包构成示意图

　　8.2 算法包目录

　　算法包名称应包含以下信息 :算法标识 、厂商代号 、版本号 。算法包应以 zip格式压缩 , 目录结构应符合表 1。

　　3

　　GB/T 46351—2025

　　表 1 算法包目录及文件组成

　　目录名称

　　是否必要

　　文件/子目录

　　说明

　　bin

　　是

　　程序文件

　　存放算法程序 、算法模型等文件

　　script

　　否

　　脚本文件

　　算法程序启动 、停止和状态查询脚本 :

　　1) 启动脚本 ,脚本名应为 start;

　　2) 停止脚本 ,脚本应为 stop;

　　3) 状态查询脚本 ,脚本名应为 status

　　data

　　否

　　以算法标识为 目录

　　存放算法体验样 本 数 据 ,如 用 于 演 示 的 图 片文件 、视频文件

　　META- INF

　　是

　　packageinfo. xml

　　算法包信息描述文件 ,见附录 A 中 A. 1

　　以算法标识为 目录

　　cover

　　封面附件资料目 录 ,存 放 用 于 展 示 算 法 能 力封面的图片或视频文件

　　condition

　　应用场景附件资 料 目 录 ,存 放 用 于 展 示 算 法能力应用场景的说明文件

　　managementinfo.json

　　算法属性信息

　　technicalinfo.json

　　算法技术信息

　　8.3 算法属性信息

　　8.3. 1 算法属性信息概述

　　算法属性信息包括算法标识 、算法名称 、算法功能说明 、适用场所 、封面信息及应用条件 。算法属性信息描述字段见 A. 2。

　　8.3.2 算法标识

　　算法标识是算法全生命周期中的唯一标记 ,要求如下 :

　　a) 算法标识应体现算法的功能特性 ,优先使用行业专业术语 、英文全称或缩写 ;

　　b) 算法标识应由英文小写字母 、数字和 “_ ”构成 ,长度应不超过 30字节 。

　　8.3.3 算法名称

　　算法名称要求如下 。

　　a) 算法名称应使用名词 +动词结构 ,如安全帽检测 。

　　b) 算法名称中不应出现带有歧视 、偏见的字样 。

　　c) 算法名称应使用多文种 ,其中 :

　　1) 汉字字符长度不少于 8个字节 ,不超过 50个字节 ;

　　2) 其他文种根据中文合理翻译 ,不超过 150个字节 。

　　8.3.4 算法功能说明

　　用于说明算法的核心功能 ,描述可解决哪些特定场景下的哪些问题 ,要求如下 。

　　a) 功能说明应符合伦理道德要求 ,不应出现带有歧视 、偏见的字样 。

　　b) 算法功能说明应使用多文种 ,其中 :

　　4

　　GB/T 46351—2025

　　1) 汉字字符长度不少于 10个字节 ,不超过 1 000个字节 ;

　　2) 其他文种根据中文合理翻译 ,不超过 1 500个字节 。

　　8.3.5 适用场所

　　描述算法的适用场所(如城市交通 、住宅建筑等) 。

　　8.3.6 封面信息

　　封面信息要求如下 :

　　a) 应具有算法应用场景的辨识度 ,宜用图形化的方式展示算法的应用场景和效果 ;

　　b) 应为图片或视频格式 ;

　　c) 如涉及隐私内容 ,应打码方式进行处理 ;

　　d) 如涉及人物的图片 ,应避开人脸正面照 。

　　8.3.7 应用条件

　　描述算法的使用要求(如环境) 、适用场景 、不适用场景等 。

　　示例 :

　　人脸视频识别算法的应用条件如下 :

　　a) 监控画面中人脸无遮挡 ;

　　b) 图像清晰可见 ,无遮挡 ,避免过曝 、过暗 、失真 、色差等现象 ;

　　c) 适用单人场景且眼睛鼻子不能有遮挡 ;不适用多人场景 。

　　8.4 算法技术信息

　　8.4. 1 算法技术信息概述

　　算法技术信息包括版本号 、数据类型 、运行环境 、占用系统资源 、性能规格 、参数以及输出 。

　　算法技术信息描述字段见 A. 3。

　　8.4.2 版本号

　　版本号是区分算法迭代的不同版本 ,是不同版本的唯一标记 。

　　版本号由主版本号 、子版本号和修订版本号三段构成 ,各段之间用“.”分割 ,如 1. 3. 2。

　　8.4.3 数据类型

　　数据类型包括图片 、视频 、音频 、特征信息 、文本的一种或几种 。

　　8.4.4 运行环境

　　运行环境包括算法运行的设备类型 、计算平台和操作系统 :

　　a) 设备类型包括通用 GPU服务 、嵌入式设备 ;

　　b) 计算平台主要是算法加速器的类型和型号 。

　　8.4.5 占用系统资源

　　描述算法运行所需的算力 、显存 、内存 、CPU核心数 、硬盘空间 、闪存大小等资源 。

　　8.4.6 性能规格

　　用于算法使用者制定算法使用方案 。性能规格与数据类型相关 ,不同数据类型的性能应分别列举描述 。

　　5

　　GB/T 46351—2025

　　8.4.7 参数

　　算法对所分析内容进行处理所需的各项参数 , 以计算机视觉算法为例 ,包括以下参数 :

　　a) 检测识别算法或行为分析算法设置的检测区域或者屏蔽区域 ;

　　b) 行为分析算法设置的方向或角度(跨线的方向) 、灵敏度 、模式和时间 ;

　　c) 其他算法的输入参数 。

　　参数定义见附录 B。

　　8.4. 8 输出

　　算法运行后输出的数据 , 以计算机视觉算法为例 ,包括以下结果数据 :

　　a) 特征模型 ;

　　b) 目标属性 ;

　　c) 事件信息 ,事件应唯一定义 ,算法事件码是算法事件的唯一标记 。

　　9 多算法管理系统的接口要求

　　9. 1 接口概述

　　多算法管理系统的接口见图 3。

　　图 3 多算法管理系统接口

　　9.2 资源查询

　　应支持查询计算资源的请求 , 由其响应返回具体的计算资源(包括显存 、存储部件 、内存 、CPU 等)的可用量 。

　　接口定义应符合表 2。

　　表 2 资源查询接口定义

　　URL

　　GET/iot/global/0-global/model/attribute/get/AlgoPackageScheduling/SearchResources

　　功能

　　资源查询

　　协议

　　https/http

　　认证方式

　　摘要认证

　　返回信息

　　见表 3

　　6

　　GB/T 46351—2025

　　表 3 资源查询接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　计 算 平 台 服 务资源

　　PhysicalInforma- tion

　　object

　　必选

　　计算设备中计算平台服务的存储和运行资源

　　可用存储空间

　　+ storage

　　int

　　必选

　　单位为兆字节(MB)

　　可用内存

　　+ memory

　　int

　　必选

　　单位为兆字节(MB)

　　可用 CPU百分比

　　+CPU

　　int

　　必选

　　取值[0,100]

　　计算平台

　　+ chip

　　string

　　16

　　必选

　　设备软件版本

　　+ softwareVersion

　　string

　　32

　　必选

　　设备软件版本 ,x. y.z格式

　　总设备存储空间

　　totalStorage

　　int

　　必选

　　单位为兆字节(MB)

　　总设备内存

　　totalMemory

　　int

　　必选

　　单位为兆字节(MB)

　　计算节点资源

　　AbilityInfos

　　array

　　必选

　　计算节点的存储和运行资源

　　计算节点 ID

　　+ nodeID

　　string

　　64

　　必选

　　引擎编号为 XXXYYY形式 ,其中 XXX表示物理引擎号 ,不需要 0 占位 ,YYY表示虚拟引擎号 ,需要 0 占位 。

　　仅有物理引擎 ,例如 ,10:10表示物理引擎 10。有物理引擎 和 虚 拟 引 擎 , 例 如 , 10002: 10表 示 物 理引擎 10,002表示虚拟引擎 2

　　可用显存

　　+ videoMemory

　　int

　　可选

　　在通用 GPU上 运 行 的 算 法 ,是 使 用 GPU 的 显 存来存放模型和数据 ,单位为兆字节(MB) 。赋值说明 :在 nodeID赋值为物理引擎(如 1)的时候返回

　　可用智能内存

　　+AImemory

　　int

　　可选

　　在 SoC上运行的算法 ,需要在 SoC上分配出一块连续内存来存放模 型 和 数 据 ,这 块 连 续 的 内 存 称之为智能内存 ,单位为兆字节(MB) 。

　　赋值说明 :在 nodeID赋值为物理引擎(如 1) 的 时候返回

　　可用内存

　　+ memory

　　int

　　必选

　　算法程序运行所 需 的 内 存 ,单 位 为 兆 字 节(MB) 。赋值说明 :在 nodeID赋值为物理引擎(如 1) 的 时候返回

　　可用 CPU百分比

　　+CPU

　　int

　　必选

　　算法程序运行所需的 CPU使用率 ,范围[0,100] 。赋值说明 :在 nodeID赋值为物理引擎(如 1) 的 时候返回

　　剩余算力值

　　+ ability

　　int

　　必选

　　范围[0, 100] 。算 法 包 消 耗 的 算 力 是 开 发 之 后 ,在设备上测试出具 体 数 值 ,记 录 在 算 法 包 的 描 述文件中 ; 当 算 法 包 调 度 到 设 备 之 后 , 设 备 基 于 运行的算法包消耗 算 力 ,计 算 出 剩 余 的 算 力 (100-已使用的算力) 。

　　视频算力计算 :单路占用芯片百分比 。

　　图片算 力 计 算 : 单 路 每 秒 处 理 图 像 占 用 芯 片 百分比 。

　　赋值说明 : 在 nodeID 赋 值 为 物 理 引 擎 (如 1) 时返回

　　7

　　GB/T 46351—2025

　　表 3 资源查询接口返回信息 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　算法加载信息

　　+AlgoLoadInfo

　　object

　　可选

　　一个计算节点只加载一个算法包 。

　　赋值说明 : 在 nodeID 赋 值 为 虚 拟 引 擎(如 1001)时返回

　　算法包 ID

　　++algoPackageID

　　string

　　128

　　必选

　　算法包是算 法 描 述 和 算 法 程 序 结 合 在 一 起 的 一种成果物格式 ,作 为 算 法 的 实 体 进 行 分 发 。算 法包 ID是由算法仓库统一生成

　　加载状态

　　++status

　　string

　　32

　　必选

　　Loading表示加载中 。

　　Complete表示加载完成 。

　　Fail表示加载失败

　　占用算力

　　++occupyAbility

　　int

　　可选

　　表示该算 法 包 任 务 运 行 之 后 的 算 力 占 比 , status为 loading时有效

　　任 务 运 行 信 息

　　列表

　　+TaskInfoList

　　array

　　可选

　　当有任务 运 行 的 情 况 下 返 回 该 节 点,赋 值 说 明 :在 nodeID赋值为虚拟引擎(如 1001)时返回

　　任务 ID

　　++taskID

　　string

　　64

　　必选

　　由数字和字母构成 ,不支持特殊字符

　　任务状态

　　++status

　　string

　　10

　　必选

　　wait表示等待执行 。

　　running表示正在执行 。

　　complete表示执行完成 。

　　fail表示执行失败

　　基础运行环境

　　+basePackage

　　string

　　32

　　可选

　　AIOP表示支持一站式感知智能训练平台 训 练 的算法模型运行的基础运行环境 。

　　HEOP表示嵌入式计算设备基础运行环境 。 HCOP表示通用计算设备基础运行环境 。

　　APS表示算法包调度运行环境 。

　　赋值说明 :在 nodeID赋值为物理引擎(如 1) 时 候返回

　　9.3 算法分发

　　应支持算法包下发到计算设备 ,或者下发算法包下载链接地址,由其通过链接获取算法成果物 。接口定义应符合表 4。

　　表 4 算法分发接口定义

　　URL

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/AddAlgoPackage

　　功能

　　添加算法包下载地址

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 5

　　返回信息

　　见表 6

　　8

　　GB/T 46351—2025

　　表 5 算法分发接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　算 法 包 下 载 地址类型

　　filePathType

　　string

　　32

　　必选

　　地址类型为 URL

　　算法包下载地址

　　filePath

　　string

　　2 048

　　必选

　　依赖于 filePathType的 定 义 ,赋 值 参 考 filePath- Type定义

　　算法包 ID

　　algoPackageID

　　string

　　128

　　必选

　　算法包是 算 法 描 述 和 算 法 程 序 结 合 在 一 起 的一种成果 物 格 式 , 作 为 算 法 的 实 体 进 行 分 发 。算法包 ID是由算法仓库统一生成

　　算法标识 ID

　　algoID

　　array

　　30

　　必选

　　算法标识是算法全生命周期中的唯一标记

　　算法包校验值

　　sha256

　　string

　　64

　　必选

　　校验算法包的完整性

　　算法授权

　　encrypt

　　object

　　可选

　　算法授权信息

　　标识

　　+ authorizedType

　　string

　　128

　　必选

　　许可方式标识

　　授权服务

　　+Address

　　object

　　必选

　　授权服务地址

　　地址类型

　　++addressType

　　string

　　16

　　必选

　　授权服务地址类型有以下几种 :

　　hostname表示域名 ;

　　ipaddress表示 IP地址

　　域名

　　++hostname

　　string

　　256

　　可选

　　依赖于 addressType, 赋 值 为 hostname时 可 选有效

　　IPv4

　　++IPv4Address

　　string

　　32

　　可选

　　依赖 于 addressType, 赋 值 为 ipaddress 时 可 选有效

　　IPv6

　　++IPv6Address

　　string

　　128

　　可选

　　依赖 于 addressType, 赋 值 为 ipaddress 时 可 选有效

　　认证间隔时间

　　+interval

　　int

　　必选

　　单位为秒(s)

　　计算节点

　　nodeID

　　string

　　64

　　可选

　　平台下发算法包 时 如 果 带 有 计 算 节 点,则 默 认算法包绑定该结算节点

　　表 6 算法分发接口返回信息

　　名称

　　标识符

　　类型

　　最大长度

　　(字节)

　　必选/可选

　　备注

　　状态

　　status

　　int

　　必选

　　状态取值有以下几种 :

　　200表示设备响应正确 ,接口返回正确数据 ;

　　400表示客户 端 请 求 参 数 错 误 , 指 代 客 户 端 产生的错误 ,如参数错误 、报文格式错误等 ;

　　403表示用户 通 过 了 身 份 验 证 , 但 是 不 具 有 访问资源所需的权限 ;

　　404表示所请求的资源不存在 ,或不可 用 ,特 指URL不支持 ;

　　500表示客户 端 请 求 有 效 , 服 务 器 处 理 时 发 生了错误 ,表示设备本身的原因导致

　　9

　　GB/T 46351—2025

　　表 6 算法分发接口返回信息 (续)

　　名称

　　标识符

　　类型

　　最大长度

　　(字节)

　　必选/可选

　　备注

　　错误码

　　code

　　int

　　必选

　　见附录 C

　　错误信息

　　errorMsg

　　string

　　64

　　必选

　　错误信息

　　业务参数

　　data

　　object

　　必选

　　9.4 实例启动

　　应支持向计算设备发出启动算法实例的指令 ,计算设备使用分发给其的算法包启动算法实例 ,准备执行算法任务 。

　　接口定义应符合表 7。

　　表 7 实例启动接口定义

　　URL

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/StartAlgo

　　功能

　　启动运行算法包

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 8

　　返回信息

　　见表 9

　　表 8 实例启动接口输入参数

　　名称

　　标识符

　　类型

　　最大长度

　　(字节)

　　必选/可选

　　备注

　　计算节点

　　nodeID

　　string

　　64

　　必选

　　算法包 ID

　　algoPackageID

　　string

　　128

　　必选

　　表 9 实例启动接口返回信息

　　名称

　　标识符

　　类型

　　最大长度

　　(字节)

　　必选/可选

　　备注

　　状态

　　status

　　int

　　必选

　　状态取值有以下几种 :

　　200表示设备响应正确 ,接口返回正确数据 ;

　　400表示客户 端 请 求 参 数 错 误 , 指 代 客 户 端 产生的错误 ,如参数错误 、报文格式错误等 ;

　　403表示用户 通 过 了 身 份 验 证 , 但 是 不 具 有 访问资源所需的权限 ;

　　404表示所请求的资源不存在 ,或不可 用 ,特 指URL不支持 ;

　　500表示客户 端 请 求 有 效 , 服 务 器 处 理 时 发 生了错误 ,表示设备本身的原因导致

　　错误码

　　code

　　int

　　必选

　　见附录 C

　　错误信息

　　errorMsg

　　string

　　64

　　必选

　　业务参数

　　data

　　object

　　必选

　　10

　　GB/T 46351—2025

　　9.5 实例停止

　　应支持向计算设备发出停止算法实例的指令 ,停止已启动的算法实例 , 释放算法实例占用的系统资源 。

　　接口定义应符合表 10。

　　表 10 实例停止接口定义

　　URL

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/StopAlgo

　　功能

　　停止运行算法包

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 11

　　返回信息

　　见表 12

　　表 11 实例停止接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　计算节点

　　nodeID

　　string

　　64

　　必选

　　算法包 ID

　　algoPackageID

　　string

　　128

　　必选

　　表 12 实例停止接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　状态

　　status

　　int

　　必选

　　状态取值有下几种 :

　　200表示设备响应正确 ,接口返回正确数据 ;

　　400表示客户 端 请 求 参 数 错 误 , 指 代 客 户 端 产生的错误 ,如参数错误 、报文格式错误等 ;

　　403表示用户 通 过 了 身 份 验 证 , 但 是 不 具 有 访问资源所需的权限 ;

　　404表示所请求的资源不存在 ,或不可 用 ,特 指URL不支持 ;

　　500表示客户 端 请 求 有 效 , 服 务 器 处 理 时 发 生了错误 ,表示设备本身的原因导致

　　错误码

　　code

　　int

　　必选

　　见附录 C

　　错误信息

　　errorMsg

　　string

　　64

　　必选

　　业务参数

　　data

　　object

　　必选

　　9.6 算法卸载

　　应支持向计算设备发出卸载算法的指令 ,卸载分发给其的算法 ,释放算法成果物占用的存储空间 。

　　11

　　GB/T 46351—2025

　　接口定义应符合表 13。

　　表 13 算法卸载接口定义

　　URL

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/DeleteAlgoPackage

　　功能

　　卸载算法包

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 14

　　返回信息

　　见表 15

　　表 14 算法卸载接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　算法包 ID

　　algoPackageID

　　string

　　128

　　必选

　　表 15 算法卸载接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　状态

　　status

　　int

　　必选

　　状态取值有以下几种 :

　　200表示设备响应正确 ,接口返回正确数据 ;

　　400表示客户 端 请 求 参 数 错 误 , 指 代 客 户 端 产生的错误 ,如参数错误 、报文格式错误等 ;

　　403表示用户 通 过 了 身 份 验 证 , 但 是 不 具 有 访问资源所需的权限 ;

　　404表示所请求的资源不存在 ,或不可 用 ,特 指URL不支持 ;

　　500表示客户 端 请 求 有 效 , 服 务 器 处 理 时 发 生了错误 ,表示设备本身的原因导致

　　错误码

　　code

　　int

　　必选

　　见附录 C

　　错误信息

　　errorMsg

　　string

　　64

　　必选

　　业务参数

　　data

　　object

　　必选

　　9.7 任务派发

　　应支持向计算设备发出派发任务的指令 ,其中算法任务主要参数有分析数据来源 、分析数据规则 、任务执行计划以及分析结果推送目的地址,由其执行算法任务 ,产生分析结果 。

　　接口定义应符合表 16。

　　12

　　GB/T 46351—2025

　　表 16 任务派发接口定义

　　操作标识

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/AddTask

　　功能

　　添加算法任务

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 17

　　返回信息

　　见表 18

　　表 17 任务派发接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务 ID

　　taskID

　　string

　　64

　　必选

　　UUID,全局唯一标识 。

　　当平 台 下 发 的 任 务 ID 非 空 值 时 , 设 备 做 重 复校验 ,并返回任务 ID与平台下发的一致 。

　　当平台下发的任 务 ID 为 空 值 时 ,任 务 ID 由 设备生成确保唯一性 ,并返回给平台

　　任务名称

　　taskName

　　string

　　128

　　可选

　　任务优先级

　　priority

　　int

　　可选

　　范围[1,100] ,1 表示最低优先级 ,100表示最高优先级 。设备处理 高 优 先 级 任 务 时 , 低 优 先 级任务停 止 执 行 (可 通 过 停 止 提 供 分 析 数 据 来控制)

　　计算节点

　　nodeID

　　string

　　64

　　必选

　　算法包的 ID

　　algoPackageID

　　string

　　128

　　必选

　　算法标识 ID

　　algoID

　　string

　　30

　　必选

　　分析数据来源

　　DataSource

　　object

　　必选

　　分析源类型

　　+ sourceType

　　string

　　16

　　必选

　　video表示实时流 ,

　　picture表示图片 ,

　　videoPolling表示视频轮询(实时间隔分析多路实时流 ,识别码流中的 目标和属性) ,

　　picturePolling表示图片抓 拍 轮 询(实 时 分 析 多路固定间隔抓图 ,识别图片中的 目标和属性) , historyVideo表示历史流视频 ,

　　accessDevEventAnalysis表 示 接 入 设 备 触 发 事件的二次分析 ,

　　audioPolling表示音频轮询 ,

　　text表示文本

　　轮询时间

　　+pollingTime

　　int

　　可选

　　单 位 为 秒 ( s) , sourceType为 videoPolling 或picturePolling时必填有效

　　13

　　GB/T 46351—2025

　　表 17 任务派发接口输入参数 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　轮 询 抓 图 原 始图片是否保存

　　+ savePollingPic Enabled

　　bool

　　可选

　　当 sourceType为 picturePolling时 有 效 , 将 原始图片保存是为 了 排 查 问 题 ,判 断 是 否 有 漏 报警的情况 。使 能 该 字 段(true) , 则 定 时 抓 图 后会 将 原 始 图 片 存 储 , 无 论 有 没 有 报 警 默 认是 false

　　分配的算力值

　　+ ability

　　int

　　可选

　　一个物理引擎支 持 划 分 为 4 个 算 力 值 , 用 于 分配该任 务 占 用 指 定 引 擎 的 算 力 额 。 如 该 任 务只需要 2个算力 值 ,则 该 引 擎 可 同 时 跑 两 路 任务 。无该字段默认按 1个算力分配

　　取流地址

　　+Stream

　　object

　　可选

　　当 SourceType为 video或 historyVideo 时有效

　　取流 URL

　　++RTSPURL

　　string

　　2 048

　　必选

　　平台 保 证 URL 的 可 访 问 性 , 鉴 权 在 URL 中体现

　　算法分析规则

　　++rule

　　string

　　1 024

　　必选

　　取流地址

　　+StreamList

　　array

　　可选

　　监控点编号

　　+ + cameraIndex- Code

　　string

　　64

　　可选

　　当视频轮询任务 时 ,一 个 任 务 存 在 多 个 取 流 地址,平台可 给 每 路 流 增 加 一 个 唯 一 标 识 , 报 警的时候 ,携带该信息

　　取流地址

　　++RTSPURL

　　string

　　2 048

　　必选

　　平台 保 证 URL 的 可 访 问 性 , 鉴 权 在 URL 中体现

　　取图地址

　　+Picture

　　array

　　可选

　　当 SourceType为 picture或 picturePolling时有效

　　图片 ID

　　++PID

　　string

　　64

　　必选

　　图片唯一标识 ID, 由平台生成管理

　　图片地址

　　++PICURL

　　string

　　256

　　必选

　　支持 URL鉴权 ,鉴权信息放在 URL参数中 。

　　图片分 析 任 务 , 推 荐 分 析 任 务 支 持 图 片 上 限100张

　　通道分析

　　+Channel

　　object

　　可选

　　含义与 sourceType相关联 ,

　　sourceType值 为 video 表 示 取 对 应 通 道 的 实时流 ,

　　sourceType值为 videoPolling表 示 对 应 通 道 进行轮询取流 ,

　　sourceType值 为 picturePolling表 示 对 应 通 道进行轮询抓拍

　　通道号列表

　　++ channels

　　array

　　必选

　　具有同一分析规 则 的 通 道 号 数 组 , 可 用 于 视 频轮询任务

　　通道列表分析

　　+ channelList

　　array

　　16

　　可选

　　一个通道对应一个规则 ,含义与 sourceType相关联 ,sourceType值 为 video 表 示 取 对 应 通 道的实 时 流 , sourceType值 为 videoPolling表 示对应 通 道 进 行 轮 询 取 流 , sourceType值 为 pic- turePolling表示对 应 通 道 进 行 轮 询 抓 拍 , 与 取流地址还有取图地址互斥

　　14

　　GB/T 46351—2025

　　表 17 任务派发接口输入参数 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　通道号

　　++ channel

　　int

　　必选

　　预置点 ID

　　++presetID

　　int

　　可选

　　音频通道列表

　　+audioChannelList

　　object

　　可选

　　音频通道号

　　++audioChannels

　　array

　　必选

　　报 警 目 标 框 叠加使能

　　+ alarmTargetOver- lay

　　bool

　　可选

　　分析时长

　　+analysisDuration

　　int

　　可选

　　单位为秒(s)

　　结果推送地址

　　Destination

　　array

　　可选

　　接收方类型

　　+type

　　string

　　64

　　必选

　　ServerKafka 表 示 kafka 类 型 的 消 息 中 间 件服务 。

　　ServerClient表示 HTTPS的服务

　　地址类型

　　+ addressType

　　string

　　16

　　必选

　　取值有以下几种 :

　　ipaddress表示 IP地址 ;

　　hostname表示域名

　　域名

　　+hostname

　　string

　　256

　　可选

　　依赖于 addressType,赋值为 hostname

　　IPv4

　　+IPv4Address

　　string

　　32

　　可选

　　依赖于 addressType,赋值为 ipaddress

　　IPv6

　　+IPv6Address

　　string

　　128

　　可选

　　依赖于 addressType,赋值为 ipaddress

　　端口

　　+portNo

　　int

　　必选

　　认证用户名

　　+ userName

　　string

　　64

　　可选

　　认证密码

　　+passWord

　　string

　　64

　　可选

　　自定义信息

　　customInfo

　　string

　　4 096

　　可选

　　用于平台在任务 中 透 传 自 定 义 信 息 , 一 般 用 于匹配分析结果

　　15

　　表 18

　　

　　任务派发接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务 ID

　　taskID

　　string

　　32

　　可选

　　唯一标识

　　任务所需算力值

　　needAbility

　　int

　　可选

　　任务失败 ,且失败 原 因 为 算 力 不 足 时 该 节 点 必填返回

　　9. 8 任务查询

　　应支持向计算设备发出分析任务查询的指令 , 返回设备所执行的全部分析任务 ,包含各分析任务参数 。

　　GB/T 46351—2025

　　接口定义应符合表 19。

　　表 19 任务查询接口定义

　　操作标识

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/SearchTask

　　功能

　　查询分析任务信息列表

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 20

　　返回信息

　　见表 21

　　表 20 任务查询接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务信息列表

　　taskID

　　string

　　必选

　　当平 台 下 发 的 任 务 ID 非 空 值 时 , 设 备 做 重 复校验 ,并 返 回 任 务 ID 与 平 台 下 发 的 一 致 。 当平台下发的任务 ID 为 空 值 时 ,任 务 ID 由 设 备生成确保唯一性 ,并返回给平台

　　表 21 任务查询接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务 ID

　　taskID

　　string

　　64

　　必选

　　任务名称

　　taskName

　　string

　　128

　　可选

　　任务优先级

　　priority

　　int

　　可选

　　范围[1,100]

　　计算节点

　　nodeID

　　string

　　64

　　必选

　　算法包的 ID

　　algoPackageID

　　string

　　128

　　必选

　　算法标识 ID

　　algoID

　　string

　　128

　　必选

　　分析数据来源

　　DataSource

　　object

　　必选

　　分析源类型

　　+ sourceType

　　string

　　16

　　必选

　　video表示实时流 ,

　　picture表示图片 ,

　　videoPolling表示视频轮询(实时间隔分析多路实时流 ,识别码流中的 目标和属性) ,

　　picturePolling表示图片抓 拍 轮 询(实 时 分 析 多路固定间隔抓图 ,识 别 图 片 中 的 目 标 和 属 性) , historyVideo表示历史流视频 ,

　　text表示文本

　　前 端 相 机 分 析的事件类型

　　+ eventType

　　array

　　可选

　　当 sourceType为 accessDevEventAnalysis时有效

　　16

　　GB/T 46351—2025

　　表 21 任务查询接口返回信息 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　轮询时间

　　+pollingTime

　　int

　　可选

　　单 位 为 秒 ( s) , sourceType为 videoPolling 或picturePolling时必填有效

　　轮 询 抓 图 原 始图片是否保存

　　+ savePollingPic Enabled

　　bool

　　可选

　　当 sourceType为 picturePolling时 有 效 , 将 原始图片保存是为 了 排 查 问 题 ,判 断 是 否 有 漏 报警的情况 。使 能 该 字 段(true) , 则 定 时 抓 图 后会 将 原 始 图 片 存 储 , 无 论 有 没 有 报 警 默 认是 false

　　分配的算力值

　　+ ability

　　int

　　可选

　　一个物理引擎支 持 划 分 为 4 个 算 力 值 , 用 于 分配该任 务 占 用 指 定 引 擎 的 算 力 额 。 如 该 任 务只需要 2个算力 值 ,则 该 引 擎 可 同 时 跑 两 路 任务 。无该字段默认按 1个算力分配

　　取流地址

　　+Stream

　　object

　　可选

　　取流 URL

　　++RTSPURL

　　string

　　2 048

　　必选

　　鉴权在 URL 中体现

　　算法分析规则

　　++rule

　　string

　　1 024

　　必选

　　取图地址

　　+Picture

　　array

　　可选

　　图片地址

　　++PICURL

　　string

　　必选

　　支持 URL鉴权 ,鉴权信息放在 URL参数中 。

　　图片分析任务 ,推 荐 分 析 任 务 支 持 图 片 上 限 为200张

　　通道分析

　　+Channel

　　object

　　可选

　　含义与 sourceType相关联 ,

　　sourceType值 为 video 表 示 取 对 应 通 道 的 实时流 ,

　　sourceType值为 videoPolling表 示 对 应 通 道 进行轮询取流 ,

　　sourceType值 为 picturePolling表 示 对 应 通 道进行轮询抓拍

　　通道号列表

　　++ channels

　　array

　　必选

　　具有同一分析规 则 的 通 道 号 数 组 , 可 用 于 视 频轮询任务

　　通道列表分析

　　+ channelList

　　array

　　16

　　可选

　　一个通道对应一个规则 ,含义与 sourceType相关联 ,sourceType值 为 video 表 示 取 对 应 通 道的实 时 流 , sourceType值 为 videoPolling表 示对应 通 道 进 行 轮 询 取 流 , sourceType值 为 pic- turePolling表示对 应 通 道 进 行 轮 询 抓 拍 , 与 取流地址还有取图地址互斥

　　通道号

　　++ channel

　　int

　　必选

　　预置点 ID

　　++presetID

　　int

　　可选

　　音频通道列表

　　+audioChannelList

　　object

　　可选

　　17

　　GB/T 46351—2025

　　表 21 任务查询接口返回信息 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　音频通道号

　　++audioChannels

　　array

　　必选

　　报 警 目 标 框 叠加使能

　　+ alarmTarget Overlay

　　bool

　　可选

　　分析时长

　　+analysisDuration

　　int

　　可选

　　单位为秒(s)

　　结果推送地址

　　Destination

　　array

　　必选

　　接收方类型

　　+type

　　string

　　64

　　必选

　　ServerKafka表示 kafka,

　　ServerClient表示 HTTPS

　　地址类型

　　+ addressType

　　string

　　16

　　必选

　　取值有以下几种 :

　　ipaddress表示 IP地址 ;

　　hostname表示域名

　　域名

　　+hostname

　　string

　　256

　　可选

　　依赖于 addressType,赋值为 hostname

　　IPv4

　　+IPv4Address

　　string

　　32

　　可选

　　依赖于 addressType,赋值为 ipaddress

　　IPv6

　　+IPv6Address

　　string

　　128

　　可选

　　依赖于 addressType,赋值为 ipaddress

　　端口

　　+portNo

　　int

　　必选

　　认证用户名

　　+ userName

　　string

　　64

　　可选

　　认证密码

　　+password

　　string

　　64

　　可选

　　自定义信息

　　customInfo

　　string

　　4 096

　　可选

　　9.9 任务修改

　　应支持向计算设备发出派发分析任务修改的指令 ,对分析任务的参数进行调整 。接口定义应符合

　　表 22。

　　表 22 任务修改接口定义

　　操作标识

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/ModifyTaskRule

　　功能

　　修改分析任务规则

　　协议

　　https/http

　　认证方式

　　摘要认证

　　输入参数

　　见表 23

　　返回信息

　　见表 24

　　18

　　GB/T 46351—2025

　　表 23 任务修改接口输入参数

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务 ID

　　taskID

　　string

　　64

　　必选

　　任务名称

　　taskName

　　string

　　256

　　可选

　　任务优先级

　　priority

　　int

　　可选

　　范围[1,100]

　　算法包的 ID

　　algoPackageID

　　string

　　128

　　必选

　　算法标识 ID

　　algoID

　　string

　　30

　　必选

　　分析数据来源

　　DataSource

　　object

　　必选

　　分析源类型

　　+ sourceType

　　string

　　16

　　必选

　　video表示实时流 ,

　　picture表示图片 ,

　　videoPolling表示视频轮询(实时间隔分析多路实时流 ,识别码流中的 目标和属性) ,

　　picturePolling表示图片抓 拍 轮 询(实 时 分 析 多路固定间隔抓图 ,识别图片中的 目标和属性) , historyVideo表示历史流视频 ,

　　accessDevEventAnalysis表 示 接 入 设 备 触 发 事件的二次分析 ,

　　audioPolling表示音频轮询 ,

　　text表示文本

　　前 端 相 机 分 析的事件类型

　　+ eventType

　　array

　　可选

　　当 sourceType 为 accessDevEventAnalysis 时有效

　　轮询时间

　　+pollingTime

　　int

　　可选

　　单 位 为 秒 ( s) , sourceType为 videoPolling 或picturePolling时必填有效

　　轮 询 抓 图 原 始图片是否保存

　　+ savePollingPic Enabled

　　bool

　　可选

　　当 sourceType为 picturePolling时 有 效 , 将 原始图片保存是为 了 排 查 问 题 ,判 断 是 否 有 漏 报警的情况 。使 能 该 字 段(true) , 则 定 时 抓 图 后会 将 原 始 图 片 存 储 , 无 论 有 没 有 报 警 默 认是 false

　　分配的算力值

　　+ ability

　　int

　　可选

　　一个物理引擎支 持 划 分 为 4 个 算 力 值 , 用 于 分配该任 务 占 用 指 定 引 擎 的 算 力 额 。 如 该 任 务只需要 2个算力 值 ,则 该 引 擎 可 同 时 跑 两 路 任务 。无该字段默认按 1个算力分配

　　上报 AI任 务 检测事件

　　+ AIOPEventEn- abled

　　bool

　　可选

　　无该 字 段 默 认 true, true 表 示 AI算 法 上 报AIOP事件 ,false表示上报专业智能事件

　　报 警 目 标 框 叠加使能

　　+ alarmTarget Overlay

　　bool

　　可选

　　分析时长

　　+analysisDuration

　　int

　　可选

　　单位为秒(s)

　　算法分析规则

　　rule

　　string

　　1 024

　　可选

　　19

　　GB/T 46351—2025

　　表 23 任务修改接口输入参数 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　通道列表分析

　　channelList

　　array

　　16

　　可选

　　一个通道对应一个规则 ,含义与 sourceType相关 ,sourceType值 为 video 表 示 取 对 应 通 道 的实时 流 , sourceType值 为 videoPolling表 示 对应 通 道 进 行 轮 询 取 流 , sourceType值 为 pic- turePolling表示对 应 通 道 进 行 轮 询 抓 拍 , 与 取流地址还有取图地址互斥

　　通道号

　　+ channel

　　int

　　必选

　　音频通道列表

　　audioChannelList

　　object

　　可选

　　音频通道号

　　+ audioChannels

　　array

　　必选

　　表 24 任务修改接口返回信息

　　名称

　　标识符

　　类型

　　最大长度

　　(字节)

　　必选/可选

　　备注

　　状态

　　status

　　int

　　必选

　　状态取值有以下几种 :

　　200表示设备响应正确 ,接口返回正确数据 ;

　　400表示客户 端 请 求 参 数 错 误 , 指 代 客 户 端 产生的错误 ,如参数错误 、报文格式错误等 ;

　　403表示用户 通 过 了 身 份 验 证 , 但 是 不 具 有 访问资源所需的权限 ;

　　404表示所请求的资源不存在 ,或不可 用 ,特 指URL不支持 ;

　　500表示客户 端 请 求 有 效 , 服 务 器 处 理 时 发 生了错误 ,表示设备本身的原因导致

　　错误码

　　code

　　int

　　必选

　　见附录 C

　　错误信息

　　errorMsg

　　string

　　64

　　必选

　　业务参数

　　data

　　object

　　必选

　　9. 10 状态查询

　　应支持向计算设备发出查询分析任务状态的指令 , 由其返回指定分析任务的执行状态 。接口定义应符合表 25。

　　表 25 状态查询接口定义

　　操作标识

　　POST/iot/global/0-global/model/service/operate/AlgoPackageScheduling/SearchTaskStatus

　　功能

　　查询分析任务状态

　　协议

　　https/http

　　认证方式

　　摘要认证

　　返回信息

　　见表 26

　　20

　　GB/T 46351—2025

　　表 26 状态查询接口返回信息

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　任务状态列表

　　TaskStatusList

　　array

　　必选

　　任务名称

　　+taskName

　　string

　　64

　　可选

　　任务 ID

　　+taskID

　　string

　　64

　　必选

　　由数字和字母构成 ,不支持特殊字符

　　算法包的 ID

　　+ algoPackageID

　　string

　　128

　　必选

　　任务状态

　　+ status

　　string

　　必选

　　wait表示等待执行 。

　　running表示正在执行 。

　　complete表示执行完成 。

　　fail表示执行失败

　　任务状态

　　+ statusList

　　object

　　可选

　　当任务中有多个 通 道 时 ,需 要 返 回 每 个 通 道 的执行情况

　　通道号

　　++ channelID

　　string

　　64

　　必选

　　图片唯一标识 ID, 由平台生成管理

　　任务状态

　　++status

　　string

　　必选

　　wait表示等待执行 。

　　running表示正在执行 。

　　complete表示执行完成 。

　　fail表示执行失败

　　执行进度

　　+progress

　　int

　　可选

　　范围[1,100] 。

　　实时流任务没有进度 。

　　历史流任务和图片分析任务 ,才有进度

　　占用算力值

　　+ ability

　　int

　　必选

　　[0,100]

　　分 析 失 败 的 图片列表

　　+FailedPicList

　　array

　　可选

　　仅在图片分析任务的情况下可选返回

　　图片 ID

　　++PID

　　string

　　64

　　必选

　　图片唯一标识 ID, 由平台生成管理

　　分析数据来源

　　+DataSource

　　object

　　可选

　　分析源类型

　　++sourceType

　　string

　　16

　　必选

　　video表示实时流 ,

　　picture表示图片 ,

　　videoPolling表示视频轮询(实时间隔分析多路实时流 ,识别码流中的 目标和属性) ,

　　picturePolling表示图片抓 拍 轮 询(实 时 分 析 多路固定间隔抓图 ,识别图片中的 目标和属性) , historyVideo表示历史流视频 ,

　　accessDevEventAnalysis表 示 接 入 设 备 触 发 事件的二次分析 ,

　　audioPolling表示音频轮询 ,

　　text表示文本

　　分析时长

　　+ + analysisDura- tion

　　int

　　可选

　　单位为秒(s)

　　21

　　GB/T 46351—2025

　　表 26 状态查询接口返回信息 (续)

　　名称

　　标识符

　　类型

　　最大长度(字节)

　　必选/可选

　　备注

　　通道列表

　　++ channelList

　　array

　　可选

　　通道号

　　+++ channel

　　int

　　必选

　　预置点 ID

　　+++presetID

　　int

　　必选

　　分析规则为算法 输 入 参 数 , 可 根 据 具 体 的 算 法类型参考算法字典中的输入参数 AIOP 的算法输入参数中 ,最大 支 持 16个 规 则 , 每 个 规 则 满配时的大小 1 000字 节 左 右 , 因 此 该 节 点 最 大值设置为 16k字节

　　是否已配置规则

　　+ + + configure- dRule

　　bool

　　可选

　　9. 11 任务删除

　　应支持向计算设备发出删除分析任务的指令 , 由其停止并删除指定的分析任务 。接口定义应符合