Examples - ffmpeg-api-cloud

Use these examples when you want a concrete request shape before reading the full API reference.

Quickstart

Run your first job end to end.

FFprobe

Inspect media metadata with ffprobe.

Webhooks

Receive job completion events.

API Reference

See the endpoint definitions and schemas.

Create a job with a public URL

curl -X POST https://ffmpeg-api.cloud/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "binary": "ffmpeg",
    "input": [
      {
        "type": "url",
        "url": "https://example.com/input.mp4"
      }
    ],
    "outputs": {
      "audio": {
        "fileName": "audio.mp3",
        "contentType": "audio/mpeg"
      }
    },
    "ffmpegArgs": [
      "-i",
      "input0",
      "-vn",
      "-c:a",
      "libmp3lame",
      "{{audio}}"
    ]
  }'

Check job status

curl https://ffmpeg-api.cloud/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Fetch job results

curl https://ffmpeg-api.cloud/v1/jobs/JOB_ID/result \
  -H "Authorization: Bearer YOUR_API_KEY"