MediaCDN API
Публичный API для управления видеоконтентом, стриминга и получения метаданных с CDN-узлов. Поддерживает HLS, DASH, WebRTC-трансляции и адаптивный битрейт.
MediaCDN — сеть доставки видеоконтента
Загружайте исходники, транскодируйте в HLS/DASH, раздавайте с 312 edge-узлов по всему миру. Все манифесты и сегменты кешируются на периферии — TTFB от 38 ms.
Введение
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 req | 1 минута / IP |
| С токеном | 2 000 req | 1 минута / ключ |
| Загрузка файлов | 50 GB | в сутки / аккаунт |
| Транскодирование | 200 мин | в сутки / аккаунт |
| Одновременные стримы | 10 000 | на канал |
Список видео
| Параметр | Тип | Описание |
|---|---|---|
status | string | Фильтр по статусу: ready, processing, live, error |
quality | string | Минимальное доступное качество: 480p, 720p, 1080p, 4k |
tag | string | Фильтр по тегу, напр. sport, movie, podcast |
limit | int | Кол-во записей, по умолчанию 20, макс 100 |
cursor | string | Курсор пагинации из предыдущего ответа |
// Нажмите «Отправить», чтобы выполнить запрос
{ "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 } }
| ID | Title | Status | Duration | Quality | Views |
|---|
Видео по ID
| Параметр | Тип | Описание |
|---|---|---|
id required | string | Идентификатор видео, напр. vid_9k2m4x |
include | string | Дополнительные данные: 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 } ] }
Потоковое воспроизведение
| Параметр | Тип | Описание |
|---|---|---|
id required | string | Идентификатор видео или live-канала |
protocol | string | hls (по умолчанию), dash, webrtc |
quality | string | Принудительное качество, иначе — adaptive |
token | string | Подписанный токен доступа (для приватного контента) |
Поток отдаётся через 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
Загрузка видео
{ "title": "Обзор матча: Барселона — Реал", "tags": ["sport", "football"], "visibility": "public", "transcode_profiles": ["480p", "720p", "1080p"], "source": { "type": "upload", "filename": "match.mp4", "size_bytes": 2147483648 } }
| Поле | Тип | Описание |
|---|---|---|
title required | string | Название видео (до 200 символов) |
tags | string[] | Теги для фильтрации и рекомендаций |
visibility | string | public · unlisted · private |
transcode_profiles | string[] | Профили рендишенов для генерации |
source | object | Метаданные исходного файла |
{ "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 }
Прогресс загрузки — нажмите, чтобы начать.
Транскодирование
{ "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 }
Удалить видео
// 204 No Content // Заголовки: X-RateLimit-Remaining: 9, X-Cache: BYPASS
Удаление идемпотентно: повторный вызов возвращает 204. Рендишены и сегменты вычищаются со всех edge-узлов в течение 60s. Операция необратима.
Статистика
{ "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-канал
| Параметр | Тип | Описание |
|---|---|---|
id required | string | Идентификатор live-канала, напр. live_f1_main |
protocol | string | hls · 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" }