Developers

Build on VII.
Ship video intelligence in hours, not months.

REST API with OpenAPI spec. `@vii/app-sdk` for platform apps. `@vii/ui-kit` for the shared UI layer. Build custom applications or plug VII into your existing infrastructure.

Quick Start

Three steps to your first analysis.

Install

pnpm install
pnpm --filter @vii/app-shell dev

Initialize

import { defineApp, useVideoAPI } from '@vii/app-sdk'
import { Button } from '@vii/ui-kit'

Analyze

function Dashboard() {
  const api = useVideoAPI()
  const run = async () => {
    const job = await api.submit(
      'https://storage.example.com/security-cam.mp4',
      { sampleRate: 2, appId: 'security' }
    )
    const status = await api.getStatus(job.jobId)
  }
}

REST API

Clean, predictable, documented.

Every endpoint follows the same conventions. JSON in, JSON out. Full OpenAPI 3.1 spec available for code generation.

POST/api/v1/videosSubmit a video for full-pipeline analysis

GET/api/v1/videos/:id/eventsQuery detected events for a video

POST/api/v1/searchSemantic search across analyzed footage

GET/api/v1/alertsList triggered alerts across processed videos

GET/api/v1/videos/:id/statusCheck video processing status

GET/api/v1/videos/:id/summaryRetrieve AI-generated video summary

View full API reference →OpenAPI 3.1 · JSON

App SDK

Shared app surfaces, typed end to end.

Shared TypeScript Contracts

Typed app manifests, hooks, and UI props keep platform apps aligned with the shell and API response shapes.

Zod-Backed Manifest Validation

App manifests are validated against shared schemas before registration so invalid routes and themes fail early.

Platform App Registration

Register platform apps with manifest-driven configuration. Your app gets SSO, RBAC, and shared data access inside the shell.

Accent Theming

Declare your app's accent theme in the manifest. The platform shell applies it automatically — no custom CSS required.

Provider Abstraction

Switch VLM providers with one config change. Gemini today, GPT-4V tomorrow — same code, same output schema.

Self-Hosted Friendly

VII can be deployed in controlled environments; external model or network access depends on how you configure the stack.

App Marketplace

Build apps that run inside the platform.

Apps built for VII get SSO for free, central admin management, shared data access, and unified permissions. Your app behaves like a native platform feature.

■SSO and authentication built-in
■Central admin + role-based access
■Shared data layer across apps
■Register in the platform shell with one manifest
■Or use the API externally — your choice

Available Apps

[SEC]

Perimeter GuardIntrusion detection for security cameras

[DEF]

Convoy TrackerVehicle tracking from aerial surveillance

[MFG]

Line InspectorAssembly line quality monitoring

[RET]

Flow AnalyticsCustomer movement heatmaps

Build on VII.Ship video intelligence in hours, not months.