Introduction

ManyCasts is a developer platform for embedding professional podcast and audio streaming capabilities into your applications. Whether you're building a live radio feature, a podcast player, or a real-time audio experience, ManyCasts gives you the tools to do it without managing your own infrastructure.

This documentation covers the REST API (v2), the JavaScript / Node.js SDK, and the Python client library. All three interfaces expose the same capabilities — choose whichever fits your stack.

New in v2.4.1: Reduced latency in the EU region, Opus codec support at 320 kbps, and a fix for Python 3.12 asyncio compatibility. See the Changelog for details.

Quick Start

Get a live stream running in three steps.

1 — Install the SDK

# JavaScript / Node.js
npm install @manycasts/sdk

# Python
pip install manycasts

2 — Initialize the client

import ManyCasts from '@manycasts/sdk';

const client = new ManyCasts({
  apiKey: 'mc_sk_••••••••••••••••',
  region: 'eu-west-1',   // eu-west-1 | us-east-1 | ap-southeast-1
});
# Python
import manycasts

client = manycasts.Client(
    api_key="mc_sk_••••••••••••••••",
    region="eu-west-1",
)

3 — Create your first stream

const stream = await client.streams.create({
  title:   'My First Stream',
  quality: 'high',   // low | medium | high
  codec:   'opus',   // aac | opus | mp3
});

console.log(stream.id);       // stm_01hx83nqp5fk2rjavt9c6e
console.log(stream.rtmpUrl);  // rtmp://ingest.manycasts.com/live/…
console.log(stream.hlsUrl);   // https://cdn.manycasts.com/hls/…/index.m3u8
Keep your Secret Key (mc_sk_…) private — never expose it in client-side code or public repositories. Use the Publishable Key (mc_pk_…) for browser-side operations. See Authentication.

Requirements

Environment Minimum version Notes
Node.js 16.0 ESM and CommonJS both supported
Python 3.8 asyncio-compatible; 3.12+ verified
Browser Chrome 90+, Firefox 88+, Safari 17+ MediaStream API required for capture
REST API — Any HTTP client; TLS 1.2 or higher

SDK Packages

Package Version Status Install
@manycasts/sdk 2.4.1 Stable npm install @manycasts/sdk
manycasts (Python) 2.4.1 Stable pip install manycasts
@manycasts/react 1.2.0 Beta npm install @manycasts/react
REST API v2 — Stable —

Next Steps

Введение

ManyCasts — платформа для разработчиков, позволяющая встраивать профессиональные функции подкастинга и стриминга аудио в ваши приложения. Создаёте ли вы интернет-радио, плеер подкастов или аудиоопыт в реальном времени — ManyCasts берёт на себя всю инфраструктуру.

Документация охватывает REST API (v2), JavaScript / Node.js SDK и Python-клиент. Все три интерфейса предоставляют одинаковые возможности — выберите тот, что подходит вашему стеку.

Новое в v2.4.1: снижена задержка в регионе EU, добавлена поддержка кодека Opus при 320 кбит/с, исправлена совместимость с asyncio в Python 3.12. Подробнее — в истории изменений.

Быстрый старт

Запустите живой поток за три шага.

1 — Установите SDK

# JavaScript / Node.js
npm install @manycasts/sdk

# Python
pip install manycasts

2 — Инициализируйте клиент

import ManyCasts from '@manycasts/sdk';

const client = new ManyCasts({
  apiKey: 'mc_sk_••••••••••••••••',
  region: 'eu-west-1',   // eu-west-1 | us-east-1 | ap-southeast-1
});
# Python
import manycasts

client = manycasts.Client(
    api_key="mc_sk_••••••••••••••••",
    region="eu-west-1",
)

3 — Создайте первый поток

const stream = await client.streams.create({
  title:   'Мой первый поток',
  quality: 'high',   // low | medium | high
  codec:   'opus',   // aac | opus | mp3
});

console.log(stream.id);       // stm_01hx83nqp5fk2rjavt9c6e
console.log(stream.rtmpUrl);  // rtmp://ingest.manycasts.com/live/…
console.log(stream.hlsUrl);   // https://cdn.manycasts.com/hls/…/index.m3u8
Держите секретный ключ (mc_sk_…) в тайне — никогда не используйте его в клиентском коде или публичных репозиториях. Для операций на стороне браузера используйте публичный ключ (mc_pk_…). Подробнее — в разделе Аутентификация.

Требования

Окружение Минимальная версия Примечания
Node.js 16.0 Поддерживаются ESM и CommonJS
Python 3.8 Совместим с asyncio; Python 3.12+ проверен
Браузер Chrome 90+, Firefox 88+, Safari 17+ Для захвата аудио требуется MediaStream API
REST API — Любой HTTP-клиент; TLS 1.2 и выше

Пакеты SDK

Пакет Версия Статус Установка
@manycasts/sdk 2.4.1 Стабильный npm install @manycasts/sdk
manycasts (Python) 2.4.1 Стабильный pip install manycasts
@manycasts/react 1.2.0 Бета npm install @manycasts/react
REST API v2 — Стабильный —

Дальнейшие шаги