开启任务

POST

/api/task

责任人：zhoukk

任务分为视频分析任务和图片分析任务，创建任务时通过请求参数mode设置，默认为视频分析任务**

mode设置为"video"，任务属于视频分析任务, 时序类型应用只支持视频分析任务

mode设置为"image", 任务属于图片分析任务

mode设置为"diff", 任务属于变化检测分析任务

任务为视频分析任务时，开启任务时拉流超时时间为15秒，视频流异常断开后会执行补黑帧，持续5分钟视频流没续上，任务自动关闭。

任务为图片分析任务时，图片上报最低间隔为1秒,最长间隔为5分钟，超过5分钟无最新上报图片，任务自动关闭

任务为变化检测分析任务时，应用只支持选择变化检测应用(即app下type: 2), 只支持调用上传变化检测图片接口, 图片上报最低间隔为1秒,最长间隔为5分钟，超过5分钟无最新上报图片，任务自动关闭

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
    "mode": "string",
    "zapk_id": "string",
    "app_ids": [
        "string"
    ],
    "device_id": "string",
    "business_id": "string",
    "video_url": "string",
    "osd": {
        "display_name": true,
        "display_box": true,
        "display_track": true,
        "display_polygon": true,
        "font_size": 0,
        "border_size": 0
    },
    "app_configs": [
        {
            "app_id": "string",
            "polygon": [
                [
                    0
                ]
            ]
        }
    ],
    "report_url": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/task' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "string",
    "zapk_id": "string",
    "app_ids": [
        "string"
    ],
    "device_id": "string",
    "business_id": "string",
    "video_url": "string",
    "osd": {
        "display_name": true,
        "display_box": true,
        "display_track": true,
        "display_polygon": true,
        "font_size": 0,
        "border_size": 0
    },
    "app_configs": [
        {
            "app_id": "string",
            "polygon": [
                [
                    0
                ]
            ]
        }
    ],
    "report_url": "string"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "task_id": "string"
    }
}

修改于 2026-09-11 09:46:27

更新应用配置

获取任务列表

开启任务

任务分为视频分析任务和图片分析任务，创建任务时通过请求参数mode设置，默认为视频分析任务**#

请求参数

请求示例代码

返回响应

任务分为视频分析任务和图片分析任务，创建任务时通过请求参数mode设置，默认为视频分析任务**