1. 任务
知眸开放平台
  • 部署介绍
  • 一键部署
  • 手动部署
  • 集群部署
  • 运维配置
  • 国标接入
  • 上云API2接入
  • 接口错误码
  • 更新记录
  • 授权
    • 授权接口
      POST
  • 应用
    • 获取应用列表
      GET
    • 更新应用配置
      PUT
  • 任务
    • 开启任务
      POST
    • 获取任务列表
      GET
    • 结束任务
      DELETE
    • 更新任务配置
      PUT
    • 上传任务图片
      POST
    • 上传变化检测图片
      POST
    • 获取指定应用AI视频
      POST
    • 关闭指定应用AI视频
      DELETE
  • 回调
    • Mqtt任务数据订阅
    • 消息回调接口
      POST
  • 流媒体
    • 获取视频流
      POST
    • 释放视频流
      DELETE
  • 优化
    • 申请任务效果优化
  • 系统
    • 获取系统详情
  • 与核心版接口改动说明
    • 核心版卸载
    • 授权模块
    • 应用模块
    • 任务模块
    • 回调
  1. 任务

开启任务

POST
/api/task
责任人:zhoukk

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

mode设置为"video",任务属于视频分析任务, 时序类型应用只支持视频分析任务
mode设置为"image", 任务属于图片分析任务
mode设置为"diff", 任务属于变化检测分析任务
任务为视频分析任务时,开启任务时拉流超时时间为15秒,视频流异常断开后会执行补黑帧,持续5分钟视频流没续上,任务自动关闭。
任务为图片分析任务时,图片上报最低间隔为1秒,最长间隔为5分钟,超过5分钟无最新上报图片,任务自动关闭
任务为变化检测分析任务时,应用只支持选择变化检测应用(即app下type: 2), 只支持调用上传变化检测图片接口, 图片上报最低间隔为1秒,最长间隔为5分钟,超过5分钟无最新上报图片,任务自动关闭
输入(video_url):
类别地址形态说明
本地文件直接填路径mp4 / flv / mkv / ts,及裸流 .h264 / .hevc
HTTPhttp:// https://HLS(.m3u8)、http-flv、http-ts 等(自动探测);含 /whep/ 的地址自动按 WHEP 拉流处理
点播/直播流rtmp:// rtmps://FLV 系列
摄像机rtsp:// rtsps://SDP 协商
裸流/低延迟udp:// rtp:// srt://这类通常承载 MPEG-TS 裸流
WebRTC 拉流whep:// wheps://对应 SRS 等 SFU 的 WHEP
国标gb28181://<通道ID>需 config.yaml 启用 GB28181 并配好上级/设备;填逻辑地址
输入编码:支持 H.264 / HEVC / VP9。
输出:
支持协议 rtmp:// rtmps:// whip:// whips:// 四类;留空则派生内部 RTMP 并返回
全套播放地址。
输出编码:H.264 / HEVC(WHIP 输出强制 H.264)。

请求参数

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
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,
        "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-11-02 02:08:32
上一页
更新应用配置
下一页
获取任务列表
Built with