API & Scripts

The Lumeo API gives you an easy way to control your application and integrate cameras, video, storage, processing, streaming and model management with your application.

API

Authentication

All requests to Lumeo's REST API require you to authenticate. You authenticate requests to Lumeo using API Keys which can be created and revoked in the Lumeo Console, .

To authenticate using an API Key, use HTTP Bearer (token) authentication and provide the API key as the token in the Authorization header when making requests to protected resources:

Authorization: Bearer <token>

Application ID

Application ID (aka Workspace ID) is a path parameter in most API Calls, and can be found in the left navigation bar under the Settings Tab.

API Keys

API Keys (aka Access Tokens) for your application can be created on Settings -> Access tokens page.

1121

Application Settings Screen


Script Helpers

Lumeo provides a python package lumeo containing scripts to make it easy to manage common operations.

Install

Install it as such from the terminal:

brew install pipx
pipx ensurepath
sudo pipx --global ensurepath # optional to allow pipx actions with --global argument

pipx install lumeo
sudo apt update
sudo apt install pipx
pipx ensurepath

pipx install lumeo

Update the installed package with:

pipx upgrade lumeo

Usage

lumeo-scripts : Lists all the scripts available from the lumeo package

ScriptDescription
lumeo-avigilon-import-camerasImport cameras from Avigilon NVR
lumeo-hanwhawave-import-camerasImport camera streams from Hanwha Vision WAVE
lumeo-verkada-import-camerasImport camera streams from Verkada
lumeo-rhombus-copy-footageDownload footage from Rhombus
lumeo-bulk-deleteBulk delete streams and deployments
lumeo-bulk-deployBulk upload clips and create deployments
lumeo-media-downloadDownload Lumeo generated media
lumeo-custom-function-create-repoCreate a custom function repo to be used with Custom Function Repo node
lumeo-load-testRun a load test on a specified Gateway