Видеохостинг,
выведенный в API.

Загрузка, транскодирование, обложки и отдача плеера — одним набором эндпоинтов. Без консоли, без ручной настройки CDN.

curl -X POST api.playhead.dev/v1/uploads скопировать

POST /v1/uploads → GET /v1/videos/:id

GET /v1/videos/vid_9k2n4x

{
  "id": "vid_9k2n4x",
  "title": "onboarding-walkthrough.mp4",
  "status": "processing",
  "duration_s": 142,
  "playback_url": null,
  "thumbnail_url": "https://cdn.playhead.dev/th/9k2n4x.jpg"
}

●кодирование дорожки 1080p…

Что делает API

Три вещи, которые он берёт на себя целиком

Приём и транскодирование

Файл или прямая ссылка на входе — набор битрейтов и адаптивный плейлист на выходе.

Раздача через CDN

Плеер получает подписанный playback_url, готовый к вставке без дополнительной настройки.

Обложки и метаданные

Автоматический кадр на превью, длительность, размер и статус — в одном объекте.

Эндпоинты

Базовый адрес: api.playhead.dev/v1

POST /uploads Создать загрузку и получить ссылку для передачи файла

GET /videos/:id Статус обработки и данные конкретного видео

GET /videos Список видео с пагинацией и фильтром по статусу

PATCH /videos/:id Изменить название, обложку или видимость

DELETE /videos/:id Удалить видео и очистить кэш на CDN

GET /videos/:id/thumbnail Кадр предпросмотра в исходном разрешении

Авторизация

Один заголовок на все запросы

Каждый запрос подписывается токеном в заголовке Authorization. Ключ выдаётся один раз при создании проекта — храните его на сервере, не в клиентском коде.

пример запроса

curl https://api.playhead.dev/v1/videos \
  -H "Authorization: Bearer ph_live_9f...c2" \
  -H "Content-Type: application/json"