开放平台

面向开发者、集成商和行业方案伙伴，开放平台提供 API、SDK、低代码工具、设备接入和消息回调能力。你可以将摄像头画面、AI识别结果和告警事件接入自有系统，快速完成空间感知应用集成。

API Playground

在文档页面直接调用“看得懂”与“千里眼”能力 API，支持参数智能提示、实时返回、沙箱/生产环境切换。

设备模拟器

无需真实空间感知传感器，虚拟设备提供模拟空间感知数据和事件，5分钟完整体验全流程。

多语言SDK

Python / JavaScript / Java / Swift / Kotlin，快速集成空间感知能力到自有系统。

Python

v3.0.0

pip install xiaoying-spatial

JavaScript

v3.0.0

npm install xiaoying-spatial

Java

v2.3.0

maven: xiaoying-spatial

Swift

v2.2.0

SPM: xiaoying-spatial

低代码

v1.0.0

拖拽式空间感知配置

REST API

OpenAPI 3.1

api.xiaoying.com

平台提供的能力

开放平台按四类能力划分，每类都有对应的文档分区，包含接口地址、请求字段和示例请求。四类能力共用同一套签名方案，接入一次即可覆盖全部接口。

设备接入

设备的创建、更新、下架与删除，设备详情查询，以及设备类型与型号映射管理。

设备管理文档 →

音视频能力

WebRTC 实时画面、录像回放、实时截图、远程对讲，以及设备参数配置接口。

WebRTC 文档 →

事件与回调

告警事件回调、心跳与在线离线判定，以及 GS/GE 类设备的事件上报。

告警对接文档 →

签名与鉴权

所有开放接口共用同一套签名方案，服务端密钥不进入客户端代码。

签名示例 →

从拿到凭证到上线

  1. 01

    获取凭证

    开放平台管理员分配 open_id / appid 与 secret_key。

  2. 02

    注册设备

    创建设备并确认其上线，获取实时画面地址。

  3. 03

    接入回调

    提供 HTTPS 回调地址，并对每个上报报文做签名校验。

  4. 04

    切换生产

    从沙箱切到生产环境，同时保留完整的请求与响应日志便于排障。

常见问题

secret_key 怎么获取？
由开放平台管理员随 open_id / appid 一并分配。它必须存放在服务端配置或密钥管理服务中，不能进入客户端代码。
所有接口的签名方式一样吗？
一致。所有开放接口使用相同的签名字段和计算顺序，因此一套实现可以同时覆盖设备、视频和事件回调。
有没有沙箱环境？
有。API Playground 与设备模拟器可以在没有真实硬件的情况下跑通完整流程，确认无误后再接入生产设备。