API Documentation

Everything you need to integrate Vyrion Vision into your applications.

Swagger UI ↗

Quick Start

Get up and running in under a minute.

1
Create an account
Sign up free at dashboard.vyrion.ai — no credit card required.
2
Generate an API Key
Go to Developer → API Keys and click Create Key. Copy it immediately.
3
Make your first API call
Use the key in the X-API-Key header to call any endpoint.

Authentication

Every API request requires one of the following authentication methods.

API KeyRecommended

For external apps and services.

X-API-Key: vyr_live_YOUR_KEY
JWT BearerSession

For dashboard-authenticated sessions.

Authorization: Bearer <token>

Base URL

https://api.vyrion.ai

Vision API Endpoints

All vision endpoints accept image uploads and return structured JSON results. Click each endpoint for parameters, code examples, and response schemas.

Video & Streaming

Process video files and live RTSP streams in real-time. Available on Pro and Enterprise plans.

RTSP / Live Stream

Connect any RTSP camera or HTTP stream for real-time AI processing with MJPEG output.

http
# Start stream via API
GET https://api.vyrion.ai/v1/video/stream?source=rtsp://camera:554/stream&task=detect

# Or use the Playground → select RTSP → enter URL → press play
GET/v1/video/stream
POST/v1/video/stream/stop
GET/v1/video/stream/live-frame
GET/v1/video/stream/stats
Video Upload

Upload video files (MP4, AVI, MOV) for batch processing. Max 2 minutes, Pro+ plans.

bash
curl -X POST https://api.vyrion.ai/v1/video/upload \
  -H "X-API-Key: vyr_live_YOUR_KEY" \
  -F "file=@footage.mp4" \
  -F "task=detect"

Pipeline Builder

Create no-code computer vision pipelines by chaining multiple AI models together. Combine detection, segmentation, classification, OCR, and enhancement in a single workflow.

How it works
  1. Drag and connect nodes on the visual graph editor
  2. Configure each node with its parameters (confidence, model, etc.)
  3. Click Run — results flow through each step automatically
  4. Download outputs or generate an Intelligence Report

Specialized Playgrounds

Pre-configured AI solutions for specific industries and use cases. Each playground is optimized with domain-specific models.

🚗
Car Parking
Occupancy detection & slot counting
🛸
Drone
Aerial object detection
👥
Crowd
People counting & density
🔥
Fire & Smoke
Fire and smoke early warning
🎯
Tracking
Multi-object tracking
📏
Queue
Queue length monitoring
💓
Heart Rate
Remote heart rate estimation
🌡️
Heatmap
Activity heatmap generation
✏️
Edge Detection
Edge/contour detection
Image Enhancement
Auto-enhance & restore
🔲
Blurring
Privacy blur filtering
📊
Zone Counting
Object counting per zone
🌍
YOLO-World
Open-vocabulary detection

Medical Lab

AI-powered medical imaging analysis for research and diagnostic assistance. Supports DICOM and standard image formats.

Brain Cancer Lab
Detect and localize brain tumors from MRI scans using a foundation model. Confidence-based risk assessment with detailed diagnostic reports.
Pneumonia Classification Lab
Analyze chest X-rays for signs of pneumonia. Batch process entire folders of scans with summary statistics and per-image detection results.
3D Volume Slicer
Load full DICOM series and explore volumetric data across axial, coronal, and sagittal planes. Interactive 3D reconstruction with multiple medical colormaps (HU Clinical, Rainbow, Hot, Bone).
DICOM Support

Upload .dcm files directly. Auto-parsed, normalized, and analyzed.

Batch Processing

Process entire folders at once. Summary with positive/negative counts.

Live Streaming

Real-time MJPEG stream with detection overlays (Pro+).

Cross-Lab Integration

Send slices from 3D Slicer directly to any detection lab.

Medical API Endpoints
POST/v1/special/medicalSingle scan analysis
POST/v1/special/medical/batchBatch scan processing
GET/v1/special/medical/streamMJPEG live stream
GET/v1/special/medical/stream/live-frameLatest frame snapshot
GET/v1/special/medical/stream/statsStream statistics

Intelligence Reports

Generate professional PDF and HTML reports from any vision analysis result. Includes detection summaries, images, statistics, and shareable links.

Report Sources
  • Playground results
  • Pipeline runs
  • Batch jobs
Features
  • PDF + HTML export
  • Public share links
  • Detection summaries

Model Marketplace

Discover community-published models or share your own custom-trained models and earn credits.

Browse Models
Explore models published by the community across various domains.
Publish Your Model
Upload custom .pt models, set a price, and earn credits when others use them.
Leaderboard
Top creators by total runs and verified models.

SDKs & Code Examples

Use our API directly with your preferred language.

Python

python
import requests

API_KEY = "vyr_live_YOUR_KEY"
BASE = "https://api.vyrion.ai"

# Object Detection
def detect_objects(image_path: str, confidence: float = 0.25):
    r = requests.post(
        f"{BASE}/v1/detect",
        headers={"X-API-Key": API_KEY},
        files={"file": open(image_path, "rb")},
        data={"confidence": confidence, "prompts": "person,car"}
    )
    return r.json()

result = detect_objects("scene.jpg")
for d in result["detections"]:
    print(f"{d['class_name']}: {d['confidence']:.2%}")

JavaScript

javascript
const API_KEY = "vyr_live_YOUR_KEY";
const BASE = "https://api.vyrion.ai";

async function detectObjects(file: File) {
  const form = new FormData();
  form.append("file", file);
  form.append("confidence", "0.4");

  const r = await fetch(`${BASE}/v1/detect`, {
    method: "POST",
    headers: { "X-API-Key": API_KEY },
    body: form,
  });
  return r.json();
}

Plans & Credit System

All plans include access to the same powerful AI models. Credits reset monthly.

Free
$0
200/mo credits
1 API key
Popular
Pro
$2.99/mo
5,000/mo credits
3 API keys
Enterprise
Custom
50,000/mo credits
10 API keys
How Credits Work
  • Each API call costs 1–2 credits depending on the endpoint
  • Credits reset to your plan limit at the start of each billing cycle
  • You can earn additional credits by publishing models on the Marketplace
  • Unused credits do not roll over
Need help? Contact support or check the Swagger UI