1. 任务
知眸开放平台
  • 部署文档
  • 接口错误码
  • 更新记录
  • 授权
    • 授权接口
      POST
  • 应用
    • 获取应用列表
      GET
  • 任务
    • 开启任务
      POST
    • 获取任务列表
      GET
    • 结束任务
      DELETE
    • 更新任务配置
      PUT
    • 上传任务图片
      POST
    • 获取指定应用AI视频
      POST
    • 关闭指定应用AI视频
      DELETE
  • 回调
    • Mqtt任务数据订阅
    • 消息回调接口
      POST
  • 流媒体
    • 获取视频流
      POST
    • 释放视频流
      DELETE
  • 与核心版接口改动说明
    • 核心版卸载
    • 授权模块
    • 应用模块
    • 任务模块
    • 回调
  1. 任务

开启任务

POST
/api/task
责任人:zhoukk

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

mode设置为"video",任务属于视频分析任务
mode设置为"image", 任务属于图片分析任务
任务为视频分析任务时,开启任务时拉流超时时间为15秒,视频流异常断开后会执行补黑帧,持续5分钟视频流没续上,任务自动关闭。
任务为图片分析任务时,图片上报最低间隔为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,
        "font_size": 0,
        "border_size": 0
    },
    "report_url": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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,
        "font_size": 0,
        "border_size": 0
    },
    "report_url": "string"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "string",
    "data": {
        "task_id": "string"
    }
}
修改于 2026-06-08 01:24:01
上一页
获取应用列表
下一页
获取任务列表
Built with