Fotovid API

Serverless media processing over HTTP — watermark, thumbnail, trim, crop, and probe, powered by ffmpeg. Nothing to deploy, nothing to scale.

Fotovid turns common ffmpeg media jobs into a single HTTP call. Send a source URL, get a processed image or video back — watermarking, cover/thumbnail extraction, trimming, cropping, audio extraction, and media probing — with no infrastructure to run.

Quickstart

Make your first watermark call in under five minutes.

Authentication

API keys, the Authorization header, and scopes.

API reference

Every endpoint, request, and response — with a live playground.

Errors

RFC 9457 problem details and the stable error-code contract.

Two ways to call

Synchronous — POST /v1/image/watermark and friends return the result inline in a single response. Best for small, fast jobs.
Asynchronous — POST /v1/tasks queues the job; poll it or receive a signed webhook. Best for large files and longer-running work.

See Synchronous vs. asynchronous to pick the right one, or jump straight to the watermarking guide.

A first taste

curl -X POST https://api.fotovid.co/v1/image/watermark \
  -H "Authorization: Bearer p6_<key_id>:<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/photo.jpg",
    "params": { "watermark_type": "text", "text": "Fotovid.co", "position": "bottom-right" }
  }'

{
  "id": "01JABCDEFGHJKMNPQRSTVWXYZ",
  "type": "image.watermark",
  "url": "https://tempfile.fotovid.co/i/<hex>.webp",
  "expires_at": "2026-06-10T12:00:00Z"
}

The url is a ready-to-download link to your processed file. Ready? Head to the Quickstart.