Media processing
Process video, audio and images over an API
You name a source and a pipeline, FlowData produces the outputs and tells you when they are ready. Billed per started output minute, images per file.
For businesses and self-employed professionals only
- Video SD 0.008 EUR per started output minute
- Video HD 0.014 EUR per started output minute
- Video 4K 0.03 EUR per started output minute
- Audio 0.004 EUR per started output minute
- Image 0.001 EUR per output file
/v1/media/jobs
curl -X POST "https://api.flowdata.one/v1/media/jobs" \
-H "Authorization: Bearer fd_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"pipeline": "ugc_video",
"input": {
"url": "https://files.example.com/in.mov"
},
"outputs": {
"clean": {
"managed": true
}
},
"reference": "order-4711"
}'
{
"id": "01J8Z6Q4T0M3S1V7B2X9K5N4RD",
"status": "queued",
"pipeline": "ugc_video",
"preset": null,
"reference": "order-4711",
"priority": "normal",
"created_at": "2026-11-09T10:00:00Z",
"started_at": null,
"finished_at": null,
"input": {
"size": null,
"duration": null,
"width": null,
"height": null,
"video_codec": null,
"has_audio": null
},
"outputs": {
"clean": {
"status": "pending",
"target": "managed",
"size": null,
"width": null,
"height": null,
"duration": null,
"sha256": null,
"download_url": null,
"expires_at": null
}
},
"options": {},
"error": null,
"processing_seconds": null,
"cancel_requested": false,
"queue_position": 1
}
Fields and structure as in the API, the values are examples.
Endpoints
POST /v1/media/jobs answers at once with 202 and an ID. You fetch the status with GET /v1/media/jobs/{id} or have it delivered by webhook.
| POST | /v1/media/jobs |
Create a job: pipeline or preset, source and outputs. |
|---|---|---|
| GET | /v1/media/jobs/{id} |
Status, progress and outputs of a job, finished outputs with a download_url. |
| GET | /v1/media/jobs |
Find jobs by your own reference (?reference=). |
| DELETE | /v1/media/jobs/{id} |
Cancel a queued job or request cancellation of a running one. |
| POST | /v1/media/uploads |
A signed address for a direct upload of a source file. |
| GET | /v1/media/usage |
Job counts and data volumes over a period. |
Pipelines
Every pipeline has fixed outputs and limits; you can create your own as team presets.
-
Video
ugc_video,chat_videoandvideoup to 2 GB and 10 minutes,course_videoup to 5 GB and 3 hours. -
Image
ugc_image,chat_imageandimageresize, crop and, if you want, watermark images up to 50 MB. -
Thumbnails and audio
video_thumbnailcreates a thumbnail,audio_extractpulls the audio track. -
Presets and watermarks
Your own presets through
POST /v1/media/presets, watermarks as a team asset throughPUT /v1/media/assets/{key}.
Where the results end up
-
At FlowData
With
managed: truethe output stays available for 7 days, and the job gives a signeddownload_url. -
With you
With
put_urlFlowData uploads the output straight into your own storage. -
Source
A public
httpsaddress or a signed direct upload throughPOST /v1/media/uploads, valid for 24 hours.
Built for production
-
Webhooks
Events like
job.finishedandjob.failedgo to registered endpoints, signed according to Standard Webhooks and retried up to 7 times. -
Idempotency
With the
Idempotency-Keyheader a repeat within 24 hours does not create a second job. -
Cost reservation
The expected maximum is reserved when the job is created, and only what was delivered is billed once it finishes.
Screenshots show the FlowData interface in German, with the example data of a fictional company.
Processing limits
We process your files on our own servers with ffmpeg and ImageMagick and store them in our object storage. They do not go to external services.
Per key, up to 60 new jobs and 600 other requests per minute, and at most 200 queued jobs per team.
Job data is kept for 90 days, outputs at FlowData for 7 days. After that they are deleted.
FlowData reserves the expected maximum when a job is created. If the balance is not enough for that, the job is rejected.
Frequently asked questions
put_url per output FlowData uploads directly there.
GET /v1/media/jobs/{id} or register a webhook endpoint.