探鸽开放平台API文档
  1. AI应用
探鸽开放平台API文档
  • 服务器API文档
    • 开放API V2
      • API For Server
        • 账户模块
          • 开发者内部 UserID登录
          • 注销账号
          • 查询用户基础信息
          • 查询用户登录信息
          • 批量查询用户Id
        • 增值服务
          • 查询套餐列表
          • 查询套餐详情
          • 查询设备开通的套餐列表
          • 提前生效套餐
          • 套餐升级/降级
          • 转移套餐
          • 清空设备的增值服务
          • 清空物联网卡的增值服务
          • 更新已开通服务的能力
          • 查询套餐转移历史记录
          • 查询增值服务产品
          • 重置设备的增值服务
          • 查询物联网卡开通的套餐
          • 对已通开套餐的生效顺序排序
        • 订单模块
          • 购买套餐(创建并完成订单)
          • 创建订单
          • 完成订单
          • 取消已完成的订单
          • 查询订单列表
          • 查询订单状态
          • 查询订单流水
        • 支付模块
          • 申请退款
          • 保存字典
        • 低功耗设备
          • 唤醒低功耗设备
        • 设备模块
          • 查询设备信息
          • 查询设备封面
          • 查询设备在线信息
          • 查询设备连接信息
          • 查询设备所有绑定关系
          • 查询设备的用户列表
          • 查询用户的设备列表
          • 查询设备产品信息
          • 查询设备产品信息 (废弃)
          • 查询设备联网卡号信息
          • 查询设备在线信息
          • 查询设备产品
          • 查询卡关联所有设备信息
          • 添加海外绑卡设备
          • 查询海外添加绑卡设备
          • 删除设备
        • 消息模块
          • 向设备发送预定义指令
          • 向设备发送消息
          • 向APP发送消息
          • 向设备发送消息-订阅消息回调通知
          • 向设备发送消息 - 取消订阅消息通知
          • 向设备发送指令 - 查询已订阅的消息通知
        • 推送模块
          • 向用户APP推送
          • 批量向用户APP推送
        • sim卡模块
          • 查询SIM卡信息
          • 查询SIM卡状态
          • 停用SIM卡(异步)
          • 恢复SIM卡(异步)
          • 查询SIM卡日用量
          • 查询套餐内4G卡流量使用情况
          • 查询SIM卡状态(废弃)
          • 停用SIM卡(异步)(废弃)
          • 恢复SIM卡(异步)(废弃)
          • 查询SIM卡日用量(废弃)
          • 查询4G卡基本信息
          • 查询4G是否锁定
          • 4G卡解锁
        • 呼叫微信小程序
          • 查询设备已授权呼叫微信小程序的用户列表
          • 微信呼叫事件通知回调
          • 查询用户已授权呼叫微信小程序的设备列表
        • 转移设备模块
          • 向UserID 转移设备
          • 向账号转移设备
          • 向开发者内部UserID 转移设备
        • 数据统计
          • 查询设备电量历史记录
          • 查询设备网络信号强度历史记录
          • 查询告警事件统计
          • 查询SD卡上报记录
          • 查询设备上下线历史记录
        • 配置模块
          • 开发者的应用配置
        • 云资源模块
          • 上报设备告警事件
          • 查询设备日志
          • 查询设备某天的云事件
          • 查询设备某天的云录像
          • 查询设备某天的云录像丢失记录
          • 统计设备云录像的录像文件
          • 查询设备应用日志
        • AI应用
          • 修改设备AI摘要配置
          • 修改设备AI检索配置
        • 物模型
          • 查询设备物模型
          • 删除设备物模型属性
          • 更新物模型
      • API For Client
        • 访问授权
          • 查询登录令牌信息
        • 账户模块
          • 注册账号
          • 绑定已有账号
          • 绑定新账号
          • 查询已绑定的第三方登录账号列表
          • 取消第三方登录
          • 登录账号
          • 验证码登录
          • 修改密码
          • 重置密码
          • 修改昵称
          • 查询账号详情
          • 苹果登录
          • Facebook登录
          • Google登录
          • LINE登录
          • 微信登录
          • 微信小程序登录
          • 注销账号
          • 退出登录
          • 刷新登录令牌
          • 一键认证注册
          • 一键重置密码
        • 配置模块
          • 开发者的自定义配置
          • 查询开发者支持的超级能力集合
          • 开发者的应用配置
        • 设备模块
          • 预添加设备
          • 添加设备
          • 查询设备列表
          • 查询设备时区
          • 设置设备时区
          • 查询设备封面
          • 查询设备连接信息
          • 修改设备名称
          • 解除绑定
          • 查询设备在线状态
          • 查询预添加设备结果
          • 门锁开锁.预授权
          • 门锁.设置开锁密码
          • 查询设备基础信息
          • 查询设备物联网卡号
          • 查询设备视频密码
          • 查询设备是否可升级
          • 发送设备固件升级指令
          • 查询设备固件升级结果
          • 查询设备固件版本升级结果
          • 签发设备令牌
        • 录像、事件模块
          • 查询云录像
          • 查询云事件
          • 按ID查询云事件
          • 按ID删除云事件
          • 按时间删除云事件
          • 查询事件推送开关
          • 更新事件推送开关
          • 查询事件标签列表
          • 查询设备截图
          • 获取设备的OSS访问令牌
          • 查询设备某天的云录像
          • 查询设备某天的云事件
          • 查询单台设备N天的云事件
          • 查询云事件摘要
        • 消息模块
          • 向设备发送预定义指令
          • 获取验证码
          • 校验验证码
          • APP向设备发送消息
        • 推送模块
          • 上报手机推送ID
        • WebRTC代理
          • 获取webRTC服务器的SDP
          • 获取打洞服务器的地址
        • 统计模块
          • 查询设备SD卡信息
          • 查询设备电量
          • 查询设备时间区间内的电量记录
          • 查询设备电量记录
          • 查询设备SD 卡使用记录
          • 上报云录像下载记录
        • 分享设备模块
          • 主人.向指定账号分享设备
          • 主人.取消分享
          • 主人.查询分享列表
          • 主人.获取分享码
          • 查询分享码信息
          • 客人.使用分享码
          • 客人.退出分享
          • 客人.申请共享设备
          • 主人.拒绝共享设备
          • 主人.同意共享设备
          • 主人.向指定用户ID分享设备
          • 主人.向指定用户ID分享设备
        • 增值服务-套餐
          • 查询服务商的套餐列表
          • 查询已购买服务
          • 查询指定订单的套餐
          • 提前生效套餐
        • 增值服务-订单
          • demo服务API
            • 小程序查询套餐的支付方式
            • 获取小程序支付跳转参数
            • 微信小程序code换openid
            • 获取支付小程序服务端token
          • 生成套餐订单
          • 拉取订单列表
          • 查询订单信息
          • 查询简要订单信息
          • 查询兑换码
          • 使用兑换码
        • 支付模块
          • 申请支付
          • 查询支付结果
          • 查询字典
          • 申请解约
        • AI识别
          • 图片识别
        • 广告模块
          • 获取广告配置
        • 呼叫微信小程序
          • 查询已授权呼叫微信小程序的设备列表
          • 授权微信小程序呼叫设备
          • 获取设备票据
          • 查询设备是否支持呼叫小程序
          • 微信小程序创建房间
        • SIM卡模块
          • 查询SIM卡信息
        • 物模型
          • 查询设备物模型
          • 更新物模型
          • 删除设备物模型属性
        • AI应用
          • AI事件检索
            GET
      • API For DeviceToken
        • 设备模块
          • 查询设备连接信息
      • 基础服务调度接口
        POST
  1. AI应用

AI事件检索

测试中
GET
/v2/ai/event-retrieval/device

请求参数

Query 参数
device_id
string 
必需
query
string 
自然语言查询
必需
start_time
integer 
开始时间戳
必需
end_time
integer 
结束时间戳
必需
limit
integer 
必需
返回结果数量上限 (大于0小于等于100)
retrieval_type
string 
必需
检索类型,text或vector
retriever_name
string 
检索器名称
必需
embedding_provider
string 
必需
embedding提供者
Header 参数
X-Tg-App-Id
string 
必需
开发者帐号的APPID
默认值:
{{app-id}}
X-Tg-Platform
string 
必需
请求来源:android/ios/pc/web/device
默认值:
{{platform}}
示例值:
androidiOSwebdevicepc
X-Tg-Sdk-Version
string 
必需
API SDK版本号:1024
默认值:
{{Sdk_version}}
Accept-Language
string 
必需
请求端的本地语言(zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar)
默认值:
{{language}}
示例值:
zh-cnzh-twen-usjakoviesptrutrdeitfrplthar
X-Tg-App-Store
string 
手机APP应用商店
可选
默认值:
{{appstore}}
X-Tg-App-Pkgname
string 
手机APP包名
必需
默认值:
{{pkgname}}
Authorization
string 
必需
服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。
默认值:
{{access_token}}
X-Tg-Date
string 
必需
当前请求的UTC+0时间(注意时区,不是本地时区)
默认值:
20060102T150405Z
X-Tg-App-Version
string 
APP版本号
可选
默认值:
{{app_version}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v2/ai/event-retrieval/device?device_id&query&start_time&end_time&limit&retrieval_type&retriever_name&embedding_provider' \
--header 'X-Tg-App-Id;' \
--header 'X-Tg-Platform;' \
--header 'X-Tg-Sdk-Version;' \
--header 'Accept-Language;' \
--header 'X-Tg-App-Store: {{appstore}}' \
--header 'X-Tg-App-Pkgname;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-App-Version: {{app_version}}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
data
array [object {6}] 
必需
uuid
string 
必需
timestamp
integer 
事件发生时间戳
必需
tag
string 
事件TAG
必需
score
number 
相关性得分
必需
description
string 
事件描述
必需
categorys
array[string]
AI自动事件分类标签
必需
msg
string 
必需
ok
integer 
必需
requestid
string 
必需
status
string 
必需
示例
{
    "code": 200,
    "data": [
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750709228,
            "tag": "motion",
            "score": 4.64054,
            "description": "一名高个子男士在房间里走动,穿着深色衣物.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750699445,
            "tag": "motion",
            "score": 4.5634727,
            "description": "一名高个子男士站在房间中央,面向光源,似乎在观察或等待.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750701167,
            "tag": "motion",
            "score": 4.490033,
            "description": "一名高个子男士在房间里走动,穿着浅色上衣和深色裤子.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750725063,
            "tag": "motion",
            "score": 4.490033,
            "description": "一名中等身型的男士在室内走动,穿着深色上衣和牛仔裤.",
            "categorys": [
                "男士",
                "室内走动"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750702854,
            "tag": "motion",
            "score": 4.4199715,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的物品.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750711717,
            "tag": "motion",
            "score": 4.4199715,
            "description": "一名高个子男士站在房间中央,面向光源,似乎在观察或操作前方的物品.",
            "categorys": [
                "男士",
                "光源"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750712215,
            "tag": "motion",
            "score": 4.4199715,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个设备.",
            "categorys": [
                "男士",
                "设备"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750706576,
            "tag": "motion",
            "score": 4.35306,
            "description": "一名高个子男士站在房间的接待台前,身体部分被照亮,周围环境较暗.",
            "categorys": [
                "男士",
                "接待台"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750726235,
            "tag": "motion",
            "score": 4.35306,
            "description": "一名穿着黑色上衣和蓝色牛仔裤的男士在室内走动,背景中可以看到一些装饰物和家具.",
            "categorys": [
                "男士",
                "室内走动"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750706983,
            "tag": "motion",
            "score": 4.1692324,
            "description": "一名高个子男士站在房间中央,面对着光源.他穿着深色衣物,头部隐约可见,但无法分辨具体发型和肤色.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750710342,
            "tag": "motion",
            "score": 4.113012,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个设备.他穿着浅色上衣和深色裤子.",
            "categorys": [
                "男士",
                "观察"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750713920,
            "tag": "motion",
            "score": 4.113012,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个设备.他穿着浅色上衣和深色裤子.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750701877,
            "tag": "motion",
            "score": 4.0590634,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个物品.他穿着浅色上衣,头部轮廓清晰.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750730807,
            "tag": "motion",
            "score": 4.007252,
            "description": "一名中等身材的男士站在室内,穿着浅色上衣和深色裤子,似乎在观察或等待.背景中有几件装饰品和一个柜台.",
            "categorys": [
                "男士",
                "室内"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750712610,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个设备.他穿着深色衣物,头部隐约可见,但无法分辨具体发型和肤色.",
            "categorys": [
                "男士",
                "观察"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750713325,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的某个设备.他穿着深色衣物,头部隐约可见,但无法分辨具体发型和肤色.",
            "categorys": [
                "男士",
                "观察"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750712014,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名高个子男士站在房间中央,背对着镜头,似乎在观察或操作前方的物体.他穿着深色衣物,头部隐约可见,但无法分辨具体发型和肤色.",
            "categorys": [
                "男士"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750726160,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名中等身型的男士在室内走动,穿着黑色上衣和深色裤子.他从背景中的门廊走向前景,经过一个展示台前.",
            "categorys": [
                "男士",
                "室内"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750725371,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名中等身型的男士在室内走动,穿着白色上衣和黑色短裤,肩上背着一个包,手里提着一个物品.",
            "categorys": [
                "男士",
                "走动"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750732860,
            "tag": "motion",
            "score": 3.9574537,
            "description": "一名中等身型的男士在室内走动,穿着白色T恤和浅色裤子.他从画面右侧走向左侧,经过一个柜台前.",
            "categorys": [
                "男士",
                "室内走动"
            ]
        },
        {
            "uuid": "1702D8OH3ICU",
            "timestamp": 1750726589,
            "tag": "motion",
            "score": 3.863443,
            "description": "一名中等身材的男士站在室内,穿着浅蓝色T恤和深色裤子,手持一个物品.背景中有几台设备放置在柜台上.",
            "categorys": [
                "男士",
                "手持物品"
            ]
        }
    ],
    "msg": "ok",
    "ok": 1,
    "requestid": "59b1a78b-c64f-46dc-a13e-ccb0e8b32f02",
    "status": "ok"
}
🟠400错误
🟠401请登录
🟠403禁止访问
🟠404资源不存在
🔴500服务器内部错误
修改于 2025-06-25 06:57:00
上一页
删除设备物模型属性
下一页
查询设备连接信息
Built with