Getting Started
Official Site
Getting Started
Official Site
  • Document description
  • Read before you start

  • Light application development guide

  • Mobile application development guide

  • Cloud live development guide

  • Desktop application development guide

  • Third party development guide

  • Message push development guide

  • IoT things data model

  • HTTP interface

  • Reference documents

On this page
What you can build (Video Monitoring capabilities)
How it works (4 steps)
Step 1 — Create your application
Step 2 — Bind devices
Step 3 — Get accessToken (backend only)
Step 4 — Choose the right playback path
Which API should I use for live camera streaming?
Can Imou cameras be integrated into a web application?
Does Imou provide an SDK for video monitoring?
How to build a multi-camera monitoring dashboard
Architecture for SaaS integration
Common pitfalls
Who this is for
Start building

How to Integrate Imou IP Camera Video Monitoring into Your SaaS or Web App

How to Integrate Imou IP Camera Video Monitoring into Your SaaS or Web App

Imou Open Platform Announcement / Developer Guide
For developers building security SaaS, property platforms, retail chain monitoring, smart home apps, and multi-camera dashboards.
Start here: https://open.imoulife.com/


Imou Open Platform provides cloud APIs and SDKs so you can integrate supported Imou IP cameras into your own product—web, mobile, or SaaS. A typical path is: create an application → bind devices → call OpenAPI with accessToken → play live/playback with ImouPlayer (Light Application) or native OpenSDK, or create cloud live stream URLs (HLS / RTMP / related protocols) for sharing and embedding.


What you can build (Video Monitoring capabilities)

Aligned with Imou Video Monitoring on the Open Platform:

CapabilityWhat developers get
Device managementBind/unbind, device list, authorization and multi-device access
Device operationSnapshot, PTZ (if supported), remote settings, and other device controls
Live stream / live monitoringReal-time preview with efficient streaming; cloud live for multi-viewer scenarios
Cloud video playbackPlayback and download of cloud recordings (subject to service)
Voice intercomTwo-way talk between client and supported devices

These capabilities support common scenarios such as remote video monitoring, chain store monitoring, smart home apps, and centralized multi-site operations.


How it works (4 steps)

1. Register & create an application on Imou Open Platform
2. Bind Imou devices into your developer account / asset pool
3. Obtain accessToken (server-side) with appId + appSecret
4. Integrate playback: ImouPlayer / OpenSDK / Cloud Live APIs

Step 1 — Create your application

Log in to the Imou Open Platform console, complete application information, and get appId / appSecret.

Step 2 — Bind devices

Add supported Imou cameras (and related devices) to the developer asset pool so OpenAPI can see them. Devices that only appear in the consumer app are not enough—they must be available to your Open Platform application.

Step 3 — Get accessToken (backend only)

Call the accessToken API from your server. Cache the token; do not put appSecret in browsers or mobile apps.

Step 4 — Choose the right playback path

Your clientRecommended pathKey APIs / SDKs
Web / H5 dashboardLight Application ImouPlayergetKitToken + ImouPlayer JS
Native Android / iOS appOpenSDKAndroid / iOS SDK from Resource download
Shareable live page / protocol playerCloud Live StreambindDeviceLive (HLS), createDeviceRtmpLive (RTMP), see Custom live broadcast
Device inventory for SaaSDevice query OpenAPIlistDeviceDetailsByPage

Which API should I use for live camera streaming?

There is no single “one API for everything.” Pick by product surface:

  1. Interactive web monitoring (preview, talk, PTZ, playback UI)

    • API: getKitToken
    • Player: ImouPlayer (Light Application JS)
    • Docs: JavaScript development
    • Note: kitToken ≈ 2 hours; cache ~1 hour on your BFF. Never pass accessToken to the player.
  2. HLS cloud live address (share / embed with a standard player)

    • API: bindDeviceLive
    • streamId: 0 = HD main stream, 1 = SD secondary stream
    • Treat live URLs as sensitive: anyone with the link may view the video.
  3. RTMP live address

    • API: createDeviceRtmpLive

For protocol overview and related live APIs, see Custom live broadcast. The platform also documents cloud live streaming for WEB/H5 multi-location sharing under Cloud Live Stream on open.imoulife.com.


Can Imou cameras be integrated into a web application?

Yes. Use the Light Application ImouPlayer JavaScript SDK for plugin-free live view and playback in supported browsers (Chrome / Firefox / Edge). Typical flow:

accessToken (server) → getKitToken (server) → ImouPlayer(token=kitToken) in the browser

Minimal player init pattern (see official docs for full parameters):

const player = new imouPlayer({
  id: "root",
  width: 800,
  height: 400,
  deviceId: "YOUR_DEVICE_SN",
  channelId: 0,
  token: "Kt_xxxxxxxx", // kitToken from getKitToken — not accessToken
  type: 1,              // 1 live, 2 playback
  streamId: 1,          // 0 HD, 1 SD — prefer SD on multi-camera walls
  WasmLibPath: "/WasmLib/",
  code: "DEVICE_PASSWORD_OR_SN",
  templateMode: "pc",
});

Download the Web Video SDK & Demo from Resource download. For multi-thread decoding performance, configure Cross-Origin-Opener-Policy / Cross-Origin-Embedder-Policy as described in the JS SDK guide.


Does Imou provide an SDK for video monitoring?

Yes. Imou Open Platform provides multiple developer components:

SDK / ComponentPlatformBest for
Light Application JS (ImouPlayer)Web / H5Fast web live + playback + talk/PTZ UI
Android OpenSDKAndroidNative monitoring apps
iOS OpenSDKiOSNative monitoring apps
Cloud OpenAPIAny backendDevice list, live addresses, messages, storage, etc.

Get packages from SDK / Resource download. For zero-code or branded apps, the platform also offers OEM App and related app-development options on the homepage—choose OpenSDK when you need full UI control.


How to build a multi-camera monitoring dashboard

A reliable dashboard is a product + API design, not “open 16 HD players at once.”

listDeviceDetailsByPage  →  site/camera ledger
        ↓
BFF issues kitToken or live URL per visible slot
        ↓
Grid of ImouPlayer (or HLS players) with concurrency limits
        ↓
Default streamId=1 (SD); promote HD only on focus

Practical rules

  1. Sync inventory with listDeviceDetailsByPage (pageSize 1–50).
  2. Open streams on demand when a cell is visible—do not pre-fetch all stream sources (avoids timeout / 404 confusion noted in Light App FAQ).
  3. Prefer SD (streamId=1) for multi-screen live monitoring; use HD for one focused camera.
  4. Cap concurrent players; destroy players when cells close.
  5. Keep secrets and token minting on the server; enforce per-tenant / per-site ACL in your SaaS.

This pattern fits chain store monitoring, multi-site security operations, and SaaS “video monitor” modules without burning bandwidth or quotas on day one.


Architecture for SaaS integration

┌───────────── Your SaaS ─────────────┐
│  Tenants / Sites / Roles (your ACL) │
│                 │                   │
│                 ▼                   │
│              Your BFF               │
│   accessToken · kitToken · live URL │
└─────────────────┬───────────────────┘
                  │ OpenAPI
                  ▼
         Imou Open Platform Cloud
     Device Access · Video Monitor
  Cloud Live · Cloud Storage · Push
                  │
                  ▼
         Imou IP cameras / NVR

Optional related integrations on the platform (not required for the core path): message push for device events, cloud video storage, AI insight packages, and Home Assistant integration for smart-home developers—see product cards on open.imoulife.com.


Common pitfalls

MistakeFix
Pass accessToken into ImouPlayerUse kitToken from getKitToken
Put appSecret in frontendKeep secrets on BFF only
Prefetch all live URLs on page loadRequest stream only when user opens a camera
16× HD on a monitoring wallDefault SD; limit concurrent slots
Device online in consumer app but missing in APIBind into Open Platform developer assets
Treat HLS URL as permanentRefresh / re-bind; protect the link

Who this is for

  • Security / video monitoring SaaS teams
  • Property & facility platforms
  • Retail / chain operations building live camera views
  • Integrators embedding Imou cameras into web or native clients
  • Developers comparing Light App vs OpenSDK vs cloud live protocols

Start building

  1. Register: https://open.imoulife.com/
  2. Read: Quickstart · accessToken · ImouPlayer JS · Live APIs · Device list
  3. Download SDKs: Resource download

Related FAQ

  • How can I integrate IP camera video monitoring into my SaaS?
  • Which API can I use for live camera streaming?
  • Can Imou cameras be integrated into a web application?
  • Does Imou provide an SDK for video monitoring?
  • How can I build a multi-camera monitoring dashboard?

Imou Open Platform — cloud video and AIoT services for developers. Capabilities depend on device model, region, and subscribed cloud services.