API v3 · стабильная версия · 99.98% uptime

Публичный API для видеохостинга

Загружайте, транскодируйте, управляйте и раздавайте видео через простой REST API. Глобальная CDN, адаптивный стриминг, автоматические субтитры и аналитика — всё в одном интерфейсе.

📖 Документация API ⚡ Быстрый старт
Запросов в сутки
128.4 M
Видео в хранилище
14.2 M
Трафик CDN / мес
1.8 PB
Средний отклик
42 ms
REST API

Основные эндпоинты

Все запросы выполняются по HTTPS. Аутентификация — через Bearer-токен в заголовке Authorization.

POST /v3/videos

Загрузка нового видеофайла. Поддерживает chunked upload для больших файлов и возобновляемую загрузку.

🔒 Bearer 📦 multipart/form-data ⚡ 20 GB макс
GET /v3/videos/{id}

Получение метаданных видео: статус транскодирования, доступные качества, длительность, превью.

🔒 Bearer 📄 application/json ⚡ 200ms
PUT /v3/videos/{id}

Обновление параметров видео: название, описание, теги, приватность, настройки плеера.

🔒 Bearer 📄 application/json ⚡ 150ms
DELETE /v3/videos/{id}

Удаление видео из хранилища. Операция необратима, все производные потоки и превью также удаляются.

🔒 Bearer 📄 application/json ⚡ 300ms
GET /v3/videos/{id}/stream

Получение подписанного URL для стриминга. Поддерживает HLS и DASH манифесты с адаптивным битрейтом.

🌐 Public 🎬 application/x-mpegURL ⚡ CDN edge
GET /v3/analytics

Аналитика просмотров: по регионам, устройствам, качеству, времени просмотра и источникам трафика.

🔒 Bearer 📄 application/json ⚡ 500ms
Быстрый старт

Примеры запросов

Скопируйте готовый код и замените YOUR_API_KEY на ваш ключ из панели управления.

# Загрузка видео curl -X POST https://api.videostream.dev/v3/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@video.mp4" \ -F "title=Demo video" \ -F "privacy=public"
Ответ сервера
{ "id": "vid_8f2a1c9e4b7d", "status": "processing", "title": "Demo video", "duration": 754, "created_at": "2025-04-12T14:32:08Z", "stream_url": null, "thumbnails": [], "qualities": ["1080p", "720p", "480p"] }
Официальные библиотеки

SDK для вашего стека

Официальные клиенты с поддержкой автоматической авторизации, retry-логики и обработки ошибок.

🟨
JavaScript / Node
npm i @videostream/api
🐍
Python
pip install videostream
🐘
PHP
composer require videostream/api
💎
Ruby
gem install videostream
☕
Java / Kotlin
dev.videostream:api:3.1.2
🐹
Go
go get github.com/videostream/api-go
Тарифы и лимиты

Квоты по планам

Лимиты применяются к каждому API-ключу отдельно. При превышении возвращается 429 Too Many Requests.

План Запросов / сек Хранилище Трафик / мес Макс. файл
Free 5 rps 10 GB 100 GB 2 GB
Pro 50 rps 1 TB 5 TB 10 GB
Enterprise 500 rps ∞ ∞ 20 GB
Changelog

Обновления API

История релизов с обратной совместимостью. Ломающие изменения объявляются за 90 дней.

3.1.2

Feature Поддержка AV1-кодека

Добавлен AV1 в список выходных форматов для транскодирования. Экономия трафика до 30% при том же качестве.

3.1.0

Feature Вебхуки для событий транскодирования

Новый эндпоинт /v3/webhooks позволяет подписаться на события video.ready, video.failed и другие.

3.0.8

Fix Улучшена стабильность chunked upload

Исправлена редкая ошибка при возобновлении загрузки после разрыва соединения на файлах > 5 GB.

3.0.0

Breaking Переход на единый формат ответов

Все ответы теперь возвращают объект с полями data и meta. Старые поля верхнего уровня помечены как deprecated.

Состояние сервиса

Статус систем

Данные обновляются каждые 30 секунд. Инцидентов за последние 30 дней не зафиксировано.

API Gateway
Operational
99.99% · 30d
Transcoding
Operational
99.97% · 30d
CDN / Streaming
Operational
100.0% · 30d
Storage
Operational
99.99% · 30d
Analytics
Operational
99.95% · 30d
Webhooks
Operational
99.98% · 30d

Начните интеграцию сегодня

Получите бесплатный API-ключ и 10 GB хранилища. Без привязки карты, без ограничений по времени.

Скопировано