Outputs and retention
Download a job's output files, and how long they are kept.
When a job succeeds, each file you asked for appears in outputs with its name, its size in bytes and a url.
Download links
A link looks like https://api.mediatofu.com/o/<token>/<job id>/<name>. Set OUTPUT_URL to one and fetch it:
curl -o out.mp4 "$OUTPUT_URL"The link needs no API key. It contains a long random token, so anyone who has the URL can download the file. Treat it like a password.
Links are served as downloads (Content-Disposition: attachment), answer HEAD, and support Range requests for resuming or seeking. The Content-Type comes from the file's extension: common video, audio and image types are set, and anything else is application/octet-stream.
How long outputs are kept
| Plan | Outputs kept |
|---|---|
| Free | 24 hours |
| Pay per use, Starter, Pro | 7 days |
The time starts when the file is saved. The plan that applies is the one active when the job started, so upgrading doesn't extend files you already have.
After that, the link returns 404 with the text Not found or expired. Run the job again to get a new file. Copy anything you need to keep to your own storage.