MediaFlow HTTP API

A compact API for media inspection, conversion and preview generation.

Supported formats

Use the formats endpoint to discover currently accepted input and output types.

GET /api/v1/formats
Accept: application/json

Asynchronous jobs

Processing operations return a job identifier. Clients can query job state until it reaches completed or failed. Job identifiers are opaque and should not be modified.

{
  "id": "01J7M4Y1Q8D2T6R9K3N5",
  "state": "processing",
  "created_at": "2026-08-15T12:00:00Z"
}

Errors

Errors have a stable machine-readable code and a human-readable message. Unknown resources return HTTP 404; unsupported methods return HTTP 405.