FFmpeg Micro API Documentation

{
  "filename": "video.mp4",
  "contentType": "video/mp4",
  "fileSize": 12345678
}

fileSize must be a JSON number (size in bytes), not a string. Quoted values like "1024" or human-readable sizes are rejected with 400.

{
  "success": true,
  "result": {
    "uploadUrl": "https://storage.googleapis.com/...",
    "filename": "1234567890-video.mp4"
  }
}

curl -X POST https://api.ffmpeg-micro.com/v1/upload/presigned-url \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "filename": "video.mp4",
    "contentType": "video/mp4",
    "fileSize": 12345678
  }'

# Replace UPLOAD_URL with the exact uploadUrl value from step 1
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @/path/to/video.mp4

{
  "filename": "1234567890-video.mp4",
  "fileSize": 12345678
}

fileSize must be a JSON number (bytes), same as step 1—not a string. It must match the uploaded object in storage; wrong types return 400 with an explicit validation error.

curl -X POST https://api.ffmpeg-micro.com/v1/upload/confirm \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "filename": "1234567890-video.mp4",
    "fileSize": 12345678
  }'

{
  "inputs": [
    { "url": "gs://<YOUR_BUCKET>/1234567890-video.mp4" }
  ],
  "outputFormat": "mp4",
  "preset": {
    "quality": "medium",
    "resolution": "1080p"
  }
}

Note: -filter_complex is not supported. See supported alternatives.

{
  "inputs": [
    { "url": "gs://<YOUR_BUCKET>/1234567890-video.mp4" }
  ],
  "outputFormat": "mp4",
  "options": [
    { "option": "-c:v", "argument": "libx264" },
    { "option": "-crf", "argument": "23" },
    { "option": "@text-overlay", "argument": {
      "text": "Hello World",
      "style": { "fontSize": 60, "x": "0.15*w", "y": "(h-text_h)/2" }
    }}
  ]
}

{
  "id": "job-uuid",
  "status": "pending",
  "inputs": [
    { "url": "gs://<YOUR_BUCKET>/1234567890-video.mp4" }
  ],
  "output_format": "mp4",
  "created_at": "2025-01-01T00:00:00Z"
}

curl -X POST https://api.ffmpeg-micro.com/v1/transcodes \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "inputs": [
      { "url": "gs://<YOUR_BUCKET>/1234567890-video.mp4" }
    ],
    "outputFormat": "mp4",
    "preset": {
      "quality": "medium",
      "resolution": "1080p"
    }
  }'

{
  "success": true,
  "jobId": "job-uuid",
  "status": "completed",
  "outputUrl": "gs://output-bucket/processed-video.mp4",
  "createdAt": "2025-01-01T00:00:00Z",
  "completedAt": "2025-01-01T00:02:30Z",
  "started_at": "2025-01-01T00:00:12Z",
  "lane": "short",
  "queue_position": 1
}

Every job runs in one of three lanes, each on its own server, so a job in one lane can never delay a job in another. Jobs with many large inputs (more than five 4K clips' worth of pixels) go to the heavy lane, which has more memory. Otherwise inputs longer than two minutes go to the long lane, and everything else to short. queue_position is how many jobs were in the queue on the worker that accepted it, yours included (1 means it was next in line). It is set once at acceptance and never updated. started_at is set the moment encoding begins: while it is null your job is waiting, and once it has a value your job is running, whatever queue_position says. started_at - created_at is submission-to-start, an upper bound on your wait because it also includes our own download and probe. Links to uploaded inputs stay valid for 24 hours, so a job that waits still runs.

curl -X GET https://api.ffmpeg-micro.com/v1/transcodes/job-uuid \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "url": "https://storage.googleapis.com/...?X-Goog-Signature=..."
}

# Get signed URL
curl -X GET https://api.ffmpeg-micro.com/v1/transcodes/job-uuid/download \
  -H "Authorization: Bearer YOUR_API_KEY"

# Then download the file
curl -O "$DOWNLOAD_URL"

{
  "media_url": "gs://<YOUR_BUCKET>/1234567890-audio.mp3",
  "language": "en",              // optional — auto-detected by default
  "task": "transcribe"           // optional — "transcribe" or "translate"
}

{
  "id": "job-uuid",
  "status": "pending",
  "media_url": "gs://<YOUR_BUCKET>/1234567890-audio.mp3",
  "output_format": "srt",
  "created_at": "2026-04-19T17:22:44.396Z"
}

curl -X POST https://api.ffmpeg-micro.com/v1/transcribe \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "media_url": "gs://<YOUR_BUCKET>/1234567890-audio.mp3" }'

curl -X GET https://api.ffmpeg-micro.com/v1/transcribe/job-uuid \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "url": "https://storage.googleapis.com/...?X-Goog-Signature=..."
}

curl -X GET https://api.ffmpeg-micro.com/v1/transcribe/job-uuid/download \
  -H "Authorization: Bearer YOUR_API_KEY"

• • status — Filter by status (queued, processing, completed, failed)
• • page — Page number (default: 1)
• • limit — Items per page (default: 20, max: 100)
• • since — Jobs created after this timestamp
• • until — Jobs created before this timestamp

curl -X GET "https://api.ffmpeg-micro.com/v1/transcodes?status=completed&page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.ffmpeg-micro.com/v1/transcodes/job-uuid" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "ok": true,
  "timestamp": "2025-10-23T14:30:45.123Z",
  "uptime": 3600.5,
  "supabase": {
    "ok": true,
    "status": 200,
    "statusText": "OK",
    "connected": true
  }
}

curl -X GET https://api.ffmpeg-micro.com/health-check