# CNVRT Live Stream Perception API

> CNVRT Live Stream Perception API is a paid API for AI agents from cnvrt.ing, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Real-time analysis of live video/audio streams (HLS/DASH/RTMP/SRT) with ASR transcription, vision, OCR, and embeddings via a WebSocket event stream

## Facts

- Endpoint: POST https://cnvrt.ing/api/convertlive
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cnvrt-live-stream-analysis-api-8e4e2aa0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hOcB47qKmLg9VfSHYkVZ0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cnvrt-live-stream-analysis-api-8e4e2aa0 -d '<json body>'
```

Example prompt: Start analyzing this live HLS stream at https://example.com/live.m3u8 in real time — enable ASR and vision features, target under 1000ms latency, and send events to my webhook at https://myapp.io/hook.

## When to prefer this

Choose this endpoint when you need real-time, low-latency analysis of an actively live stream (HLS, DASH, RTMP, SRT, Twitch, TikTok, YouTube Live) rather than a static file. It is ideal when you need multiple simultaneous perception modalities (ASR + vision + OCR + embeddings) in a single session with WebSocket event delivery. For pre-recorded or static file transcription, use CNVRT's file upload or URL transcription endpoints instead.

## Known failure modes

- VOD or static URL submitted instead of a live stream — request rejected with error
- Unsupported stream protocol or unreachable stream URL — session fails to initialize
- Invalid feature names in features array — unknown features ignored or error returned
- Agent_capture mode without using upload_url — no data received, session times out
- WebSocket connection dropped — real-time events lost, reconnection required
- Payment failure or insufficient USDC balance — 402 response, no session created

## How this service works

Real-time analysis of live streams (HLS/DASH/RTMP/SRT) with ASR, vision, and embeddings. Supports URL-based streams and agent chunked upload. Agent-only endpoint. Payment via USDC on base.

## Output

Returns a stream_id, a WebSocket URL (events_ws) to receive real-time analysis events (transcripts, detections, OCR, embeddings), and — if using agent_capture mode — an upload_url to POST media chunks to. Events arrive continuously over WebSocket as the stream is processed.

## Response schema (JSON Schema)

```json
{
 "input": {
  "type": "http",
  "method": "POST",
  "bodyType": "json",
  "bodyFields": {
   "url": {
    "type": "string",
    "required": false,
    "description": "Live stream URL (HLS, DASH, RTMP, SRT, WebRTC, Twitch, TikTok, YouTube). VOD/static URLs will be rejected. Not required if source_type is 'agent_capture'."
   },
   "webhook": {
    "type": "string",
    "required": false,
    "description": "Webhook URL to receive events (optional)"
   },
   "features": {
    "type": "array",
    "required": false,
    "description": "Features to enable: asr, vision, ocr, embeddings. Default: [asr, vision]"
   },
   "source_type": {
    "type": "string",
    "required": false,
    "description": "Source type: 'url' (default) or 'agent_capture'. Use 'agent_capture' for zero-friction chunked upload from agents."
   },
   "session_meta": {
    "type": "object",
    "required": false,
    "description": "Optional metadata for the session"
   },
   "latency_target_ms": {
    "type": "number",
    "required": false,
    "description": "Target latency in milliseconds. Default: 1000"
   }
  }
 },
 "output": {
  "type": "object",
  "required": [
   "stream_id",
   "events_ws"
  ],
  "properties": {
   "status": {
    "type": "string",
    "description": "Session status"
   },
   "events_ws": {
    "type": "string",
    "description": "WebSocket URL for real-time events"
   },
   "stream_id": {
    "type": "string",
    "description": "Unique stream session identifier"
   },
   "upload_url": {
    "type": "string",
    "description": "URL to POST media chunks (agent_capture mode only)"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cnvrt-live-stream-analysis-api-8e4e2aa0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cnvrt.ing](https://www.zero.xyz/host/cnvrt.ing/llms.txt)