单次抓拍/抽帧 - Om Agent OpenAPI

当设备支持抓拍图片时，优先使用图片抓拍；如不支持，再使用视频流单次抽帧

请求参数

Header 参数

linker-sign

string

签名

必需

Body 参数application/json

is_save

boolean

图片是否保存

必需

不传或者传空null 默认为 false 如非特殊情况此处建议设置为false,避免图片文件持久化时间过长占用磁盘

task_type

integer

任务类型，0 流抽帧 1 资源抽帧

必需

不传或者传空null的时候默认为 0

source_url

string

当任务类型为0时传入流地址，为1资源抽帧时传入文件地址

可选

is_edge

boolean

是否边缘端设备

可选

channel

string

通道ID，默认为"1"

可选

输入为空或者超限后默认选择为主通道即“1”

device_unicode

string

设备唯一标识

可选

示例

{
    "is_save": false,
    "taskType": 0,
    "is_edge": true,
    "channel": 1,
    "device_unicode": "11111"
}

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

object

必需

success

boolean

抽帧状态

必需

error_message

string

失败原因

必需

image_url

string

外网图片地址

必需

inner_image_url

string

内网图片地址

必需

device_id

string

设备ID

必需

frame_extraction_time

string

抽帧时间

必需

ext_parmas

object

业务参数

必需

task_type

integer

必需

device_unicode

string

必需

success

boolean

必需

示例

{
    "code": "49",
    "message": "labore mollit exercitation",
    "data": {
        "success": false,
        "error_message": "occaecat nostrud ea laboris",
        "image_url": "https://loremflickr.com/400/400?lock=399122462098106",
        "inner_image_url": "https://loremflickr.com/400/400?lock=3909618053094903",
        "device_id": "97",
        "frame_extraction_time": "2026-02-20 02:18:58",
        "ext_parmas": {},
        "task_type": 92,
        "device_unicode": "20"
    },
    "success": true
}