API Reference · v1.4.0

MediaCDN API

Публичный API для управления видеоконтентом, стриминга и получения метаданных с CDN-узлов. Поддерживает HLS, DASH, WebRTC-трансляции и адаптивный битрейт.

MediaCDN — сеть доставки видеоконтента

Загружайте исходники, транскодируйте в HLS/DASH, раздавайте с 312 edge-узлов по всему миру. Все манифесты и сегменты кешируются на периферии — TTFB от 38 ms.

Запросов / сек
0req/s
▲ 0.0%
Трафик (24ч)
0TB
▲ 0.0%
Live-зрители
0
▲ 0
Cache HIT
0%
▲ 0.0%
TTFB (p95)
0ms
▼ 0 ms
Запросы к edge · последние 60с —

Введение

MediaCDN — глобальная сеть доставки видеоконтента. API позволяет загружать исходники, управлять транскодированием, получать манифесты воспроизведения и аналитику в реальном времени. Все медиа-ассеты кешируются на edge-узлах, время жизни манифестов — 6s, сегментов — 30d.

Поддерживаемые форматы: MP4 · MOV · MKV · WebM · HLS · DASH. Кодек-пайплайн: H.264, H.265/HEVC, AV1, AAC, Opus.

Аутентификация

Передавайте токен в заголовке Authorization: Bearer <token>. Публичные GET-эндпоинты медиатеки доступны без токена, но с ограниченным rate limit.

# пример
curl https://content.prosto-pro-it.xyz/v1/videos \
  -H "Authorization: Bearer sk_live_••••••••"

Лимиты и квоты

ScopeЛимитОкно
Анонимные запросы60 req1 минута / IP
С токеном2 000 req1 минута / ключ
Загрузка файлов50 GBв сутки / аккаунт
Транскодирование200 минв сутки / аккаунт
Одновременные стримы10 000на канал

Список видео

GET/v1/videos
Параметры
Попробовать
Ответ
Медиатека
ПараметрТипОписание
statusstringФильтр по статусу: ready, processing, live, error
qualitystringМинимальное доступное качество: 480p, 720p, 1080p, 4k
tagstringФильтр по тегу, напр. sport, movie, podcast
limitintКол-во записей, по умолчанию 20, макс 100
cursorstringКурсор пагинации из предыдущего ответа
// Нажмите «Отправить», чтобы выполнить запрос
{
  "data": [
    {
      "id": "vid_9k2m4x",
      "title": "Гран-при: финальный круг",
      "status": "ready",
      "duration_sec": 842,
      "qualities": ["480p", "720p", "1080p", "4k"],
      "hls": "https://content.prosto-pro-it.xyz/stream/9k2m4x/master.m3u8",
      "views": 184203,
      "created_at": "2026-11-13T09:12:44Z"
    }
  ],
  "pagination": { "next_cursor": "c_7a91", "has_more": true }
}
IDTitleStatusDurationQualityViews

Видео по ID

GET/v1/videos/:id
Параметры
Ответ
ПараметрТипОписание
id requiredstringИдентификатор видео, напр. vid_9k2m4x
includestringДополнительные данные: renditions, subtitles, analytics
{
  "id": "vid_9k2m4x",
  "title": "Гран-при: финальный круг",
  "status": "ready",
  "duration_sec": 842,
  "size_bytes": 1843200000,
  "codec": "h264",
  "renditions": [
    { "quality": "1080p", "bitrate_kbps": 6000, "url": ".../1080p/index.m3u8" },
    { "quality": "720p",  "bitrate_kbps": 3000, "url": ".../720p/index.m3u8" }
  ],
  "edges": [
    { "node": "eu-fra-03", "status": "ok", "latency_ms": 34 },
    { "node": "us-nyc-07", "status": "ok", "latency_ms": 58 }
  ]
}

Потоковое воспроизведение

GET/v1/stream/:id
Параметры
Плеер
Манифест
ПараметрТипОписание
id requiredstringИдентификатор видео или live-канала
protocolstringhls (по умолчанию), dash, webrtc
qualitystringПринудительное качество, иначе — adaptive
tokenstringПодписанный токен доступа (для приватного контента)
Гран-при: финальный круг
00:00 / 14:02

Поток отдаётся через https://content.prosto-pro-it.xyz/stream/<id>/master.m3u8. Поддерживается адаптивный битрейт и ручной выбор качества.

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-STREAM-INF:BANDWIDTH=6000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3000000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1200000,RESOLUTION=854x480,CODECS="avc1.4d401f,mp4a.40.2"
480p/index.m3u8

Загрузка видео

POST/v1/upload
Body
Ответ
Прогресс
{
  "title": "Обзор матча: Барселона — Реал",
  "tags": ["sport", "football"],
  "visibility": "public",
  "transcode_profiles": ["480p", "720p", "1080p"],
  "source": { "type": "upload", "filename": "match.mp4", "size_bytes": 2147483648 }
}
ПолеТипОписание
title requiredstringНазвание видео (до 200 символов)
tagsstring[]Теги для фильтрации и рекомендаций
visibilitystringpublic · unlisted · private
transcode_profilesstring[]Профили рендишенов для генерации
sourceobjectМетаданные исходного файла
{
  "id": "vid_3n8p1k",
  "status": "processing",
  "upload_url": "https://content.prosto-pro-it.xyz/upload/3n8p1k",
  "expires_at": "2026-11-17T21:30:00Z",
  "estimated_processing_sec": 96
}

Прогресс загрузки — нажмите, чтобы начать.

Прогресс: 0% Скорость: — Статус: ожидание

Транскодирование

POST/v1/videos/:id/transcode
Body
Ответ
{
  "profiles": ["480p", "720p", "1080p", "4k"],
  "codec": "h265",
  "priority": "normal",
  "webhook_url": "https://example.com/hooks/transcode"
}
{
  "task_id": "tsk_5v2b9",
  "status": "queued",
  "estimated_sec": 180,
  "renditions": 4
}

Удалить видео

DELETE/v1/videos/:id
Ответ
// 204 No Content
// Заголовки: X-RateLimit-Remaining: 9, X-Cache: BYPASS

Удаление идемпотентно: повторный вызов возвращает 204. Рендишены и сегменты вычищаются со всех edge-узлов в течение 60s. Операция необратима.

Статистика

GET/v1/stats
Ответ
Live
{
  "period": "24h",
  "views": 1842093,
  "watch_time_hours": 42180,
  "bandwidth_tb": 18.4,
  "cache_hit_ratio": 0.981,
  "top_regions": [
    { "region": "eu", "share": 0.46 },
    { "region": "us", "share": 0.33 },
    { "region": "ap", "share": 0.21 }
  ]
}

Значения обновляются раз в 2 секунды.

Live-канал

GET/v1/live/:id
Параметры
Ответ
ПараметрТипОписание
id requiredstringИдентификатор live-канала, напр. live_f1_main
protocolstringhls · dash · webrtc (низкая задержка)
{
  "id": "live_f1_main",
  "title": "Формула-1: квалификация",
  "status": "live",
  "viewers": 84201,
  "latency_mode": "low",
  "streams": {
    "hls": "https://content.prosto-pro-it.xyz/stream/live/f1_main.m3u8",
    "webrtc": "wss://content.prosto-pro-it.xyz/rtc/live/f1_main"
  },
  "started_at": "2026-11-17T17:00:00Z"
}