Probe a Source Stream

POST

stream

probe

Probe Stream

curl --request POST \
  --url https://client.camb.ai/apis/stream/probe/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "srt://ingest.example.com:9000"
}
'

import requests

url = "https://client.camb.ai/apis/stream/probe/"

payload = { "url": "srt://ingest.example.com:9000" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'srt://ingest.example.com:9000'})
};

fetch('https://client.camb.ai/apis/stream/probe/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/stream/probe/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'srt://ingest.example.com:9000'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "video_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "width": 123,
      "height": 123,
      "frame_rate": "<string>",
      "id": "<string>"
    }
  ],
  "audio_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "sample_rate": 123,
      "channels": 123,
      "channel_layout": "<string>",
      "tags": {},
      "id": "<string>"
    }
  ],
  "data_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "id": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Overview

A preflight check that connects to a source URL and reports the tracks it carries, without creating anything. Use it to:

Verify the source is reachable before scheduling a stream.
Find the right audio track for audio_selections[].source.
Check for data tracks such as SCTE-35 ad markers.

SRT sources are supported today; RTMP and HLS ingest are coming soon. Note the trailing slash in the path: POST /stream/probe/.

Example request

curl -X POST "https://client.camb.ai/apis/stream/probe/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "srt://ingest.example.com:9000",
    "passphrase": "my-secret-passphrase",
    "stream_id": "live/primary"
  }'

import requests

payload = {
    "url": "srt://ingest.example.com:9000",
    # Only needed if the source is encrypted / requires a streamid:
    "passphrase": "my-secret-passphrase",
    "stream_id": "live/primary",
}

response = requests.post(
    "https://client.camb.ai/apis/stream/probe/",
    headers={"x-api-key": "YOUR_API_KEY"},
    json=payload,
)

response.raise_for_status()
print(response.json())

A reachable source returns its tracks:

{
  "video_streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "width": 1920,
      "height": 1080,
      "frame_rate": "25/1"
    }
  ],
  "audio_streams": [
    {
      "index": 1,
      "codec_name": "aac",
      "sample_rate": 48000,
      "channels": 2,
      "channel_layout": "stereo",
      "tags": { "language": "eng" }
    }
  ],
  "data_streams": []
}

From probe to create

Pick the audio track to process and reference it in your create payload’s audio_selections. Selectors count within a track type, so the first audio track is a:0 regardless of its overall index:

{
  "audio_selections": [
    { "id": "commentary", "source": "a:0", "source_language": 1 }
  ]
}

If you are unsure which track carries speech, start with $first_audio.

Errors

422 - Validation error, or the source could not be reached.

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

application/json

url

string

required

Source stream URL to probe, e.g. srt://example.com:9000.

passphrase

string | null

Optional passphrase for authenticated streams (commonly used with SRT).

stream_id

string | null

Optional SRT streamid the source requires. This is not the Camb.ai stream ID.

Response

Tracks discovered in the source.

video_streams

VideoStream · object[]

Video tracks discovered in the source stream.

Hide child attributes

video_streams.index

integer

Track index within the source.

video_streams.codec_name

string

Video codec, e.g. h264.

video_streams.width

integer | null

video_streams.height

integer | null

video_streams.frame_rate

string | null

Frame rate as a fraction, e.g. 25/1.

video_streams.id

string | null

MPEG-TS PID of the track (hex string), when the source is MPEG-TS. Usable in selectors like i:301.

audio_streams

AudioStream · object[]

Audio tracks discovered in the source stream.

Hide child attributes

audio_streams.index

integer

Track index within the source.

audio_streams.codec_name

string

Audio codec, e.g. aac.

audio_streams.sample_rate

integer

Sample rate in Hz, e.g. 48000.

audio_streams.channels

integer

Number of audio channels.

audio_streams.channel_layout

string | null

Channel layout, e.g. stereo.

audio_streams.tags

Tags · object | null

Track metadata from the source, e.g. {"language": "eng"}. Useful for picking the right track.

audio_streams.id

string | null

MPEG-TS PID of the track (hex string), when the source is MPEG-TS. Usable in selectors like i:301.

data_streams

DataStream · object[]

Data tracks discovered in the source stream (e.g., SCTE-35 ad markers).

Hide child attributes

data_streams.index

integer

Track index within the source.

data_streams.codec_name

string | null

Data codec, e.g. scte_35.

data_streams.id

string | null

MPEG-TS PID of the track (hex string), when the source is MPEG-TS. Usable in selectors like i:301.

Last modified on July 24, 2026

Create a StreamCreate a live stream that ingests a source feed, processes it with AI in real time, and publishes dubbed, translated, or transcribed outputs.

Probe Stream

curl --request POST \
  --url https://client.camb.ai/apis/stream/probe/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "srt://ingest.example.com:9000"
}
'

import requests

url = "https://client.camb.ai/apis/stream/probe/"

payload = { "url": "srt://ingest.example.com:9000" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'srt://ingest.example.com:9000'})
};

fetch('https://client.camb.ai/apis/stream/probe/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client.camb.ai/apis/stream/probe/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => 'srt://ingest.example.com:9000'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "video_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "width": 123,
      "height": 123,
      "frame_rate": "<string>",
      "id": "<string>"
    }
  ],
  "audio_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "sample_rate": 123,
      "channels": 123,
      "channel_layout": "<string>",
      "tags": {},
      "id": "<string>"
    }
  ],
  "data_streams": [
    {
      "index": 123,
      "codec_name": "<string>",
      "id": "<string>"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Probe a Source Stream

Overview

Example request

From probe to create

Errors

Authorizations

Body

Response

​Overview

​Example request

​From probe to create

​Errors

​Related endpoints

Authorizations

Body

Response

Overview

Example request

From probe to create

Errors

Related endpoints