Use a Stream Template

GET

stream

templates

{template_id}

payload

curl -X GET "https://client.camb.ai/apis/stream/templates/12/payload" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://client.camb.ai/apis/stream/templates/12/payload",
    headers={"x-api-key": "YOUR_API_KEY"},
)
response.raise_for_status()

payload = response.json()["payload"]

# Reschedule, then create a new stream from the template.
payload["start_time"] = "2026-08-15T18:45:00+02:00"
payload["end_time"] = "2026-08-15T21:00:00+02:00"

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

{
  "payload": {
    "name": "Matchday 3: home fixture",
    "source_stream": {
      "id": "stadium_feed",
      "url": "srt://ingest.example.com:9000",
      "category": 2
    },
    "audio_selections": [
      {
        "id": "commentary",
        "source": "$first_audio",
        "source_language": 1
      }
    ],
    "processing_profiles": [
      {
        "id": "full_dub",
        "demixing": "fast_model",
        "transcribing": "fast_model",
        "translating": "best_model",
        "revoicing": "fast_model"
      }
    ],
    "pipelines": [
      {
        "id": "spanish",
        "audio_selection": "commentary",
        "profile": "full_dub",
        "outputs": [
          { "id": "audio_es", "kind": "audio", "language": 37 },
          { "id": "subtitle_es", "kind": "subtitle", "language": 37 }
        ]
      }
    ],
    "target_streams": [
      {
        "id": "delivery",
        "type": 1,
        "url": "srt://delivery.example.com:9100",
        "inputs": [{ "asset_id": "audio_es" }]
      }
    ],
    "start_time": "2026-08-01T18:45:00+02:00",
    "end_time": "2026-08-01T21:00:00+02:00",
    "timezone": "Europe/Madrid"
  }
}

Overview

Returns the stream creation payload the template was saved from: the exact configuration of that stream, including its source, audio selections, processing profiles, pipelines and targets. The returned payload is compatible with the Create Stream request body. Its start_time and end_time are the original stream’s schedule and will be in the past, so set them to your new broadcast window before creating the stream. Templates are scoped to your workspace: requesting a template that belongs to another workspace returns 404.

curl -X GET "https://client.camb.ai/apis/stream/templates/12/payload" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://client.camb.ai/apis/stream/templates/12/payload",
    headers={"x-api-key": "YOUR_API_KEY"},
)
response.raise_for_status()

payload = response.json()["payload"]

# Reschedule, then create a new stream from the template.
payload["start_time"] = "2026-08-15T18:45:00+02:00"
payload["end_time"] = "2026-08-15T21:00:00+02:00"

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

{
  "payload": {
    "name": "Matchday 3: home fixture",
    "source_stream": {
      "id": "stadium_feed",
      "url": "srt://ingest.example.com:9000",
      "category": 2
    },
    "audio_selections": [
      {
        "id": "commentary",
        "source": "$first_audio",
        "source_language": 1
      }
    ],
    "processing_profiles": [
      {
        "id": "full_dub",
        "demixing": "fast_model",
        "transcribing": "fast_model",
        "translating": "best_model",
        "revoicing": "fast_model"
      }
    ],
    "pipelines": [
      {
        "id": "spanish",
        "audio_selection": "commentary",
        "profile": "full_dub",
        "outputs": [
          { "id": "audio_es", "kind": "audio", "language": 37 },
          { "id": "subtitle_es", "kind": "subtitle", "language": 37 }
        ]
      }
    ],
    "target_streams": [
      {
        "id": "delivery",
        "type": 1,
        "url": "srt://delivery.example.com:9100",
        "inputs": [{ "asset_id": "audio_es" }]
      }
    ],
    "start_time": "2026-08-01T18:45:00+02:00",
    "end_time": "2026-08-01T21:00:00+02:00",
    "timezone": "Europe/Madrid"
  }
}

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.

Path Parameters

template_id

integer

required

Response

The template's stream creation payload.

payload

Payload · object

required

A stream creation payload compatible with the Create Stream request body. Adjust start_time and end_time before creating a stream from it.

Last modified on August 7, 2026

curl -X GET "https://client.camb.ai/apis/stream/templates/12/payload" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://client.camb.ai/apis/stream/templates/12/payload",
    headers={"x-api-key": "YOUR_API_KEY"},
)
response.raise_for_status()

payload = response.json()["payload"]

# Reschedule, then create a new stream from the template.
payload["start_time"] = "2026-08-15T18:45:00+02:00"
payload["end_time"] = "2026-08-15T21:00:00+02:00"

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

{
  "payload": {
    "name": "Matchday 3: home fixture",
    "source_stream": {
      "id": "stadium_feed",
      "url": "srt://ingest.example.com:9000",
      "category": 2
    },
    "audio_selections": [
      {
        "id": "commentary",
        "source": "$first_audio",
        "source_language": 1
      }
    ],
    "processing_profiles": [
      {
        "id": "full_dub",
        "demixing": "fast_model",
        "transcribing": "fast_model",
        "translating": "best_model",
        "revoicing": "fast_model"
      }
    ],
    "pipelines": [
      {
        "id": "spanish",
        "audio_selection": "commentary",
        "profile": "full_dub",
        "outputs": [
          { "id": "audio_es", "kind": "audio", "language": 37 },
          { "id": "subtitle_es", "kind": "subtitle", "language": 37 }
        ]
      }
    ],
    "target_streams": [
      {
        "id": "delivery",
        "type": 1,
        "url": "srt://delivery.example.com:9100",
        "inputs": [{ "asset_id": "audio_es" }]
      }
    ],
    "start_time": "2026-08-01T18:45:00+02:00",
    "end_time": "2026-08-01T21:00:00+02:00",
    "timezone": "Europe/Madrid"
  }
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Use a Stream Template

Overview

Authorizations

Path Parameters

Response

​Overview

​Related endpoints

Authorizations

Path Parameters

Response

Overview

Related endpoints