Choose an API

PreviousNext

Realtime, Segment, and Batch — when to use which.

Lanson Live API provides three integration paths: Realtime for live streams, Segment for speech clips, and Batch for recordings. They are audio workflows, not three different models. No model selection is needed.

Decision table

ScenarioAPIEndpointWho does VAD
Live captions / dialogueRealtime WSWS /v1/audio/transcriptions/streamServer
Pre-segmented speech clips (e.g. voice UI)Segment HTTPPOST /v1/audio/transcriptionsClient
Meeting / podcast file from URLBatch jobsPOST /v1/audio/transcriptions/jobsServer (time slice)
Voice agentVoice AgentComing soon—

Realtime Voice Context

When to use: text while the person is still speaking.

  • Live captions, real-time display
  • Continuous PCM stream; server-side VAD and utterance boundaries

Characteristics:

  • WebSocket full-duplex
  • PCM16LE / 16kHz / mono
  • Millisecond-level latency

→ Realtime Overview

Segment transcription (client VAD)

When to use: your app already detected speech boundaries (VAD) and has a short clip per utterance.

  • Voice clients that upload one WAV per utterance
  • OpenAI Whisper-compatible multipart/form-data
  • Synchronous 200 response

Characteristics:

  • No server-side silence filtering — silent clips are transcribed and billed
  • ~800ms × up to 3 worker attempts per request; no HTTP auto-retry
  • On failure (502), client decides whether to resend

→ Segment API · Client-VAD guide

Batch jobs (recorded files)

When to use: complete audio file at a public URL; processing can take minutes.

  • Post-meeting / podcast processing
  • Server slices by time, concurrent chunk transcription, aggregation
  • LLM review (on by default; review: false opts out) and webhook

Characteristics:

  • HTTP async (202 + poll)
  • workflow_id is an opaque job id (local + 32 hex on the production endpoint; cf_ + 64 hex on the Cloudflare Worker deployment), not a UUID

→ Recorded Overview · Batch Jobs API

Voice Agent

Status: Coming soon

Comparison

DimensionRealtime WSSegment HTTPBatch jobs
TransportWebSocketHTTP POSTHTTP POST + GET poll
LatencyMilliseconds~≤2.4s syncMinutes (async)
InputPCM16LE streamMultipart fileJSON audio_url
OutputEvent streamTranscript JSONFull job JSON
VADServerClientServer (slice)
Success codeWS events200202

Next steps