Video Tools API

Media delivery and transcoding service. Stream, upload, and manage video assets over a simple HTTP interface.

v1.0.0 [ Base URL: /v1 ]

Streaming

GET /video/download/{id} Stream a video file ▾

Downloads (streams) a video asset by its identifier. Supports HTTP range requests for seeking.

Parameters

id string required Video identifier (UUID)

chunk integer Optional chunk index for segmented transfer

Responses

Code	Description
200	Video stream (application/octet-stream)
206	Partial content (range request)
404	Video not found

curl -i -H "Range: bytes=0-1023" https://<host>/video/download/<id>

GET /video/{id}/info Video metadata ▾

Returns metadata for a stored video asset.

Responses

Code	Description
200	Video metadata object
404	Video not found

curl -i https://<host>/video/<id>/info

POST /video/upload Upload a new video ▾

Uploads a video asset for storage and later streaming.

Parameters

body VideoUploadRequest required Multipart upload payload

Responses

Code	Description
201	Created
400	Invalid payload

curl -i -X POST -F "file=@video.mp4" https://<host>/video/upload

GET /health Service health check ▾

Liveness probe for the service.

Responses

Code	Description
200	{"status":"ok"}

curl -i https://<host>/health

Models used by the API.

Video

idstringUnique identifier

titlestringHuman-readable title

durationnumberDuration in seconds

resolutionstringe.g. "1920x1080"

urlstringStreaming URL

VideoUploadRequest

filebinaryVideo file to upload

titlestringOptional title override