Files and outputs - ffmpeg-api-cloud

The API supports two input patterns:

Upload a file first with /v1/files, then reference the returned asset ID in a job.
Pass a public URL directly in the job request.

Upload flow

Create an upload slot with POST /v1/files.
Upload the media bytes to the returned uploadUrl.
Reference the returned file ID from POST /v1/jobs.

URL flow

Pass a public URL in the input array when the source file is already reachable over HTTP.

Outputs

For FFmpeg jobs, declare named outputs in outputs and reference them in ffmpegArgs.

{
  "outputs": {
    "thumbnail": {
      "fileName": "frame.jpg",
      "contentType": "image/jpeg"
    }
  },
  "ffmpegArgs": [
    "-i",
    "input0",
    "-frames:v",
    "1",
    "{{thumbnail}}"
  ]
}

FFprobe jobs return JSON output and do not need declared file outputs.