Live Streaming Overview

The Streaming API takes a live feed, processes it with Camb.ai’s AI pipeline in real time, and publishes the results to the destinations you choose: dub a football match’s commentary into Spanish as it happens, push the dubbed feed to YouTube, and keep an HLS recording, all from one API call.

Supported source protocols: SRT is supported today. RTMP and HLS ingest are coming soon.

The streaming lifecycle

Probe (optional)

POST /stream/probe/ - inspect the source and discover its video, audio, and data tracks.

Create

POST /stream - configure source, pipelines, and targets. You get back a stream_id and output URLs.

Monitor

GET /stream/{stream_id} - poll the stream status and read the state and playback URLs of each output.

Adjust

PATCH /stream/{stream_id} - reschedule, reconfigure, or apply live adjustments such as turning dubbing on and off.

End

DELETE /stream/{stream_id} - stop the stream, or let it end automatically at its end_time.

Core concepts

A stream’s configuration is a small graph of blocks that reference each other by id:

Block	What it does
`source_stream`	The live feed to ingest (an SRT URL, or a flow’s play URL).
`audio_selections`	Names the source audio track(s) to process and their spoken language.
`processing_profiles`	How audio is processed: demixing, transcribing, translating, revoicing, each `none`, `best_model`, or `fast_model`.
`pipelines`	Connect one audio selection to one profile and declare output assets (dubbed audio, subtitles) per language.
`target_streams`	Where outputs go: your SRT/RTMP endpoints, YouTube, or Camb.ai-hosted SRT/HLS outputs.

Language and voice choices are numeric IDs from the platform’s catalog endpoints: /source-languages, /target-languages, and /list-voices.

Stream flows

Flows are standing SRT endpoints hosted by Camb.ai, independent of any single stream. Use a flow when you want a stable ingest point for your encoder (listener mode) or want Camb.ai to pull from your infrastructure and re-serve it (caller mode), then plug the flow’s URL into any stream as its source or target.

Authentication

Every request needs your API key in the x-api-key header. You can find your API key(s) in the API section of the Camb.ai studio.

curl -H "x-api-key: YOUR_API_KEY" "https://client.camb.ai/apis/stream/1234"

Endpoints

Endpoint	Purpose
`POST /stream`	Create a stream
`GET /stream/{stream_id}`	Get stream status
`PATCH /stream/{stream_id}`	Update a stream / toggle dubbing
`DELETE /stream/{stream_id}`	Terminate a running or scheduled stream
`POST /stream/probe/`	Inspect a source
`POST /flows`	Create an SRT flow
`GET /flows`	List SRT flows
`GET /flows/{flow_id}`	Get an SRT flow
`PATCH /flows/{flow_id}`	Update an SRT flow
`DELETE /flows/{flow_id}`	Delete an SRT flow

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Live Streaming Overview

The streaming lifecycle

Core concepts

Stream flows

Authentication

Endpoints

​The streaming lifecycle

​Core concepts

​Stream flows

​Authentication

​Endpoints

The streaming lifecycle

Core concepts

Stream flows

Authentication

Endpoints