任务模块
3.1 创建任务 POST /api/task
1. 请求体字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| zapk_id | - | string、必选 | 新增字段 | 应用包ID, 即旧版app_id |
| app_ids | - | array、必选 | 新增字段 | 应用ID列表, 即旧版的rules |
| device_id | - | string、可选 | 新增字段 | 设备ID, 即旧版的device |
| video_url | - | string、可选 | 新增字段 | 即旧版的input |
| report_url | - | string、可选 | 新增字段 | 即旧版的report下的httpurl |
| mode | string、可选 | string、可选 | 无变更 | 任务类型 |
| business_id | string、可选 | string、可选 | 无变更 | 业务ID |
| osd | object、可选 | object、可选 | 数据结构变更 | 视频绘制配置 |
| disable_rules | array、可选 | - | 删除字段 | 字段已移除 |
| device | string、可选 | - | 删除字段 | 字段已移除 |
| input | string、可选 | - | 删除字段 | 字段已移除 |
| output | string、可选 | - | 删除字段 | 字段已移除 |
| width | integer、可选 | - | 删除字段 | 字段已移除 |
| height | integer、可选 | - | 删除字段 | 字段已移除 |
| bitrate | boolean、可选 | - | 删除字段 | 字段已移除 |
| frame_ignore | boolean、可选 | - | 删除字段 | 字段已移除 |
| dji | object、可选 | - | 删除字段 | 字段已移除 |
| report | object、可选 | - | 删除字段 | 字段已移除 |
2. osd子级字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| display_name | boolean、可选 | boolean、可选 | 无变更 | 显示目标名称 |
| display_box | boolean、可选 | boolean、可选 | 无变更 | 显示目标框 |
| display_track | boolean、可选 | boolean、可选 | 无变更 | 显示追踪ID |
| font_size | integer、可选 | integer、可选 | 无变更 | 字体大小 |
| border_size | integer、可选 | integer、可选 | 无变更 | 边框大小 |
| display_mask | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_count | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_speed | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_angle | boolean、可选 | - | 删除字段 | 字段已移除 |
| hide_rule | array、可选 | - | 删除字段 | 字段已移除 |
| polygon | array、可选 | - | 删除字段 | 字段已移除 |
3.2 获取任务列表 GET /api/tasks
1. data字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| data | object、必选 | array、必选 | 数据结构变更 | 任务列表 |
2. task对象字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| zapk_id | - | string、必选 | 新增字段 | 应用包ID, 即旧版app_id |
| app_ids | - | array、必选 | 新增字段 | 应用ID列表, 即旧版的rules |
| device_id | - | string、可选 | 新增字段 | 设备ID, 即旧版的device |
| video_url | - | string、可选 | 新增字段 | 即旧版的input |
| report_url | - | string、可选 | 新增字段 | 即旧版的report下的httpurl |
| close_code | - | integer、可选 | 新增字段 | 任务结束码 |
| dump | - | string、可选 | 新增字段 | 任务校验码 |
| task_id | string、必选 | string、必选 | 无变更 | 任务ID |
| mode | string、可选 | string、可选 | 无变更 | 任务类型 |
| business_id | string、可选 | string、可选 | 无变更 | 业务ID |
| osd | object、可选 | object、可选 | 数据结构变更 | 视频绘制配置 |
| disable_rules | array、可选 | - | 删除字段 | 字段已移除 |
| device | string、可选 | - | 删除字段 | 字段已移除 |
| input | string、可选 | - | 删除字段 | 字段已移除 |
| output | string、可选 | - | 删除字段 | 字段已移除 |
| width | integer、可选 | - | 删除字段 | 字段已移除 |
| height | integer、可选 | - | 删除字段 | 字段已移除 |
| bitrate | boolean、可选 | - | 删除字段 | 字段已移除 |
| frame_ignore | boolean、可选 | - | 删除字段 | 字段已移除 |
| dji | object、可选 | - | 删除字段 | 字段已移除 |
| report | object、可选 | - | 删除字段 | 字段已移除 |
3. osd子级字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| display_name | boolean、可选 | boolean、可选 | 无变更 | 显示目标名称 |
| display_box | boolean、可选 | boolean、可选 | 无变更 | 显示目标框 |
| display_track | boolean、可选 | boolean、可选 | 无变更 | 显示追踪ID |
| font_size | integer、可选 | integer、可选 | 无变更 | 字体大小 |
| border_size | integer、可选 | integer、可选 | 无变更 | 边框大小 |
| display_mask | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_count | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_speed | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_angle | boolean、可选 | - | 删除字段 | 字段已移除 |
| hide_rule | array、可选 | - | 删除字段 | 字段已移除 |
| polygon | array、可选 | - | 删除字段 | 字段已移除 |
3.3 关闭任务 DELETE /api/task/{task_id}
3.4 更新任务 PUT /api/task/{task_id}
接口变更
| 项目 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| app_ids | - | array、可选 | 新增能力 | 支持动态切换应用 |
| osd | - | object、可选 | 新增能力 | 支持动态修改绘制配置 |
| display_name | boolean、可选 | boolean、可选 | 无变更 | 显示目标名称 |
| display_box | boolean、可选 | boolean、可选 | 无变更 | 显示目标框 |
| display_track | boolean、可选 | boolean、可选 | 无变更 | 显示追踪ID |
| font_size | integer、可选 | integer、可选 | 无变更 | 字体大小 |
| border_size | integer、可选 | integer、可选 | 无变更 | 边框大小 |
| hide_rule | array、可选 | - | 删除字段 | 字段已移除 |
| display_mask | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_count | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_speed | boolean、可选 | - | 删除字段 | 字段已移除 |
| display_angle | boolean、可选 | - | 删除字段 | 字段已移除 |
| polygon | array、可选 | - | 删除字段 | 字段已移除 |
3.5 上传任务图片 POST /api/task/{task_id}/image
Query参数
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| device_id | - | string、可选 | 新增字段 | 设备ID,即旧版的device |
| image_id | - | integer、可选 | 新增字段 | 图片ID,即旧版的id |
| enhance | - | integer、可选 | 新增字段 | 图片增强识别 |
| device | string、可选 | - | 删除字段 | 字段已移除 |
| id | integer、可选 | - | 删除字段 | 字段已移除 |
请求体
3.5 获取AI视频 POST /api/task/{task_id}/ailive
请求体字段
| 字段名 | 旧版 | 新版 | 变更类型 | 变更说明 |
|---|---|---|---|---|
| rtmp | - | string、可选 | 新增字段 | 指定推流地址,即旧版的output |
| bitrate | - | integer、可选 | 新增字段 | 视频码率 |
| app_ids | - | array、必选 | 新增字段 | 应用ID列表,即旧版的rules |
| output | string、可选 | - | 删除字段 | 字段已移除 |
| width | integer、可选 | - | 删除字段 | 字段已移除 |
| height | integer、可选 | - | 删除字段 | 字段已移除 |
| rules | array、可选 | - | 删除字段 | 字段已移除 |
3.6 关闭AI视频 DELETE /api/task/{task_id}/livestream/{stream}
3.7 移除其他任务接口
POST /api/task/{task_id}/flight
修改于 2026-06-10 17:16:46