Live Capture Sessions

Designed for browser microphones and softphones that produce audio incrementally. Each session supports exactly one SSE consumer at a time.

Initialize Session — `POST /analyze/live/start`

string

Optional hint used to infer the extension.

string

Explicit extension (e.g., .wav). Defaults to .mp4.

integer

Session lifetime (60-3600). Default 900s.

Response

{
  "session_id": "live_6a0a64c0",
  "conversation_id": "liveconv_353cee7a",
  "chunk_endpoint": "/analyze/live/live_6a0a64c0/chunk",
  "events_endpoint": "/analyze/live/live_6a0a64c0/events",
  "control_endpoint": "/analyze/live/live_6a0a64c0/control",
  "next_chunk_seq": 0,
  "expires_at": "2025-11-08T18:12:04.991Z",
  "status": "waiting_media"
}

Upload Chunks — `POST /analyze/live/{session_id}/chunk`

string

required

Live session identifier from /analyze/live/start.

integer

required

Zero-based, must equal next_chunk_seq.

binary

required

PCM/Opus audio chunks.

Response includes received_bytes and updated next_chunk_seq. Out-of-order uploads return 409 Conflict.

string

required

Live session identifier.

Returns the same SSE catalog as /analyze/stream.
Only one connection allowed; a second call returns 409.
When streaming completes, the session is cleaned up.

Control Session — `POST /analyze/live/{session_id}/control`

string

required

Live session identifier.

string

required

One of: finalize, cancel, keepalive

string

Optional reason for the action.

Actions

Action	Effect
`finalize`	Stop ingest and begin final processing stages.
`cancel`	Abort processing; SSE clients receive `error`.
`keepalive`	Extend TTL without uploading media.

Payload schema:

{
  "action": "finalize" | "cancel" | "keepalive",
  "reason": "optional string"
}

Response echoes status, detail, and new expires_at.

Only one SSE consumer may be attached to a live session at a time. Attempting to attach a second listener will return 409 Conflict.

Live Capture Python Cookbook (Async)

Async Python examples using httpx for implementing live capture workflows with asyncio.

Live Capture Python Cookbook (Sync)

Synchronous Python examples using requests for WSGI apps, Lambda, and non-async environments.

Introduction

Endpoints

Cookbooks

Reference

Initialize Session — `POST /analyze/live/start`

Response

Upload Chunks — `POST /analyze/live/{session_id}/chunk`

Control Session — `POST /analyze/live/{session_id}/control`

Actions

Live Capture Python Cookbook (Async)

Live Capture Python Cookbook (Sync)

​Initialize Session — POST /analyze/live/start

​Response

​Upload Chunks — POST /analyze/live/{session_id}/chunk

​Subscribe to Events — GET /analyze/live/{session_id}/events

​Control Session — POST /analyze/live/{session_id}/control

​Actions

Live Capture Python Cookbook (Async)

Live Capture Python Cookbook (Sync)

Initialize Session — `POST /analyze/live/start`

Response

Upload Chunks — `POST /analyze/live/{session_id}/chunk`

Subscribe to Events — `GET /analyze/live/{session_id}/events`

Control Session — `POST /analyze/live/{session_id}/control`

Actions