OpenAPI 3.1 Specification

Genovaxai REST & Streaming API Reference

Complete technical documentation for programmatic stream registration, bounding box querying, safety compliance webhooks, and device fleet telemetry.

BASE ENDPOINT

https://api.genovaxai.com/v1

TLS 1.3 encryption strictly enforced

AUTHENTICATION

Authorization: Bearer <API_KEY>

Obtain keys via Enterprise Console

RATE LIMITS

Standard: 1,000 req/sec / Node

Zero-drop bursts with queue buffer

POST/v1/inference/detect

Real-Time Computer Vision Inference

Dispatches a frame or RTSP stream reference to the TensorRT INT8 accelerator. Returns detected objects, confidence, 2D normalized bounding coordinates, and velocity vectors.

curl -X POST https://api.genovaxai.com/v1/inference/detect \
  -H "Authorization: Bearer vx_live_9f82..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vx-detect-v1.4",
    "threshold": 0.5,
    "source_url": "rtsp://cam08.industrial.internal/live"
  }'

200 OK Response Payload:

{ "success": true, "timestamp": "2026-11-03T09:42:10.841Z", "metadata": { "model": "vx-detect-v1.4", "precision": "int8", "latency_ms": 5.2, "device": "NVIDIA TensorRT Engine" }, "detections": [ { "id": "det-01", "label": "Industrial Forklift", "category": "vehicle", "confidence": 0.984, "bbox": [14.2, 36.5, 24.8, 41.2], "velocity": "11.4 km/h", "status": "normal" } ] }

Full API Endpoints Roster

GET/v1/cameras

List all active ONVIF/RTSP camera ingestion endpoints.

POST/v1/cameras/register

Bind a new RTSP camera stream to the cluster.

GET/v1/safety/events

Retrieve verified safety incidents and PPE violation logs.

POST/v1/safety/geofence

Define polygon exclusion boundaries for hazard zones.

GET/v1/telemetry/gpu

Inspect real-time GPU utilization, VRAM, and FPS throughput.