Extract still frames from any video as JPEG, WebP or PNG

Extract still frames from any video as JPEG, WebP or PNG: sample many for a vision model, or grab one frame at a given timestamp (a thumbnail/poster/screenshot). Modes: every frame, every Nth, a rate in seconds, keyframes, N evenly spaced, or exact timestamps. One frame at 5s: mode=timestamps, timestamps=[5], format=jpeg. Up to 1000 frames/job; result is a manifest of frames with timestamps and download URLs, kept 24h. USDC over x402; no account; input <=100 MB.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://ffpipe.dev/v1/frames

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "fps": 1,
    "maxOutputHeight": 720,
    "maxOutputWidth": 1280,
    "mode": "interval",
    "sourceUrl": "https://storage.example.com/clip.mov?signature=abc123"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": true,
          "description": "Provide EXACTLY ONE of sourceUrl (we fetch it) or upload: true (you PUT the bytes to the uploadUrl returned in the 202), plus mode. The parameter each mode needs is stated in mode's own description; every number must be a JSON number, not a string. The result is a manifest listing each frame with its timestamp and its own download URL. Unknown properties are ignored; validation runs before any charge.",
          "oneOf": [
            {
              "required": [
                "sourceUrl"
              ]
            },
            {
              "required": [
                "upload"
              ]
            }
          ],
          "properties": {
            "count": {
              "description": "`evenly_spaced` only: how many frames to spread across the window.",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "endTime": {
              "description": "Window end in seconds (0 = to the end). Must be greater than `startTime`; past the end of the media it is clamped.",
              "minimum": 0,
              "type": "number"
            },
            "format": {
              "default": "jpeg",
              "description": "Image format of each frame. `jpeg` (default) is small and accepted by every vision API; `png` is lossless; `webp` splits the difference. `jpg` is accepted as a spelling of `jpeg`.",
              "enum": [
                "jpeg",
                "jpg",
                "webp",
                "png"
              ],
              "type": "string"
            },
            "fps": {
              "description": "`interval` only: frames per second, framerate-independent. May be below 1 - `0.5` is one frame every two seconds.",
              "exclusiveMinimum": 0,
              "maximum": 120,
              "type": "number"
            },
            "maxFrames": {
              "default": 1000,
              "description": "Ceiling on how many frames this job may produce, and also the hard limit: 1000 frames is what one job's flat price covers. A request whose sampling would exceed it fails before any decoding, with the predicted count in the message.",
              "maximum": 1000,
              "minimum": 1,
              "type": "integer"
            },
            "maxOutputHeight": {
              "description": "Fit box height. Same rules as `maxOutputWidth`.",
              "maximum": 4096,
              "minimum": 0,
              "type": "integer"
            },
            "maxOutputWidth": {
              "description": "Fit box width for each frame, applied to the source's DISPLAY dimensions: aspect preserved, never upscaled, oriented to the input (a portrait clip given 1920x1080 yields 1080x1920). 0 = no limit on this axis.",
              "maximum": 4096,
              "minimum": 0,
              "type": "integer"
            },
            "mode": {
              "description": "How to pick frames. Required - there is no default, because every possible one implies a sampling rate you did not ask for. `all` every frame; `every_nth` every Nth decoded frame (needs `n`); `interval` a fixed rate in seconds (needs `fps`, may be below 1); `keyframes` keyframes only (cheap on long sources); `evenly_spaced` N samples across the window (needs `count`); `timestamps` one frame per given second (needs `timestamps`). Every mode is bounded by `maxFrames` (1000): `all` and `interval` on a long source, and `keyframes` on a dense one, can exceed it - the job then fails fast and, being our own limit rather than your mistake, earns the usual retry voucher. For long inputs prefer `interval`, `evenly_spaced` or `timestamps`.",
              "enum": [
                "all",
                "every_nth",
                "interval",
                "keyframes",
                "evenly_spaced",
                "timestamps"
              ],
              "type": "string"
            },
            "n": {
              "description": "`every_nth` only: keep every Nth DECODED frame. This is a frame index, not a time - on a variable-frame-rate source the spacing in seconds varies.",
              "minimum": 1,
              "type": "integer"
            },
            "quality": {
              "default": 85,
              "description": "Encoder quality for `jpeg`/`webp`; ignored for the lossless `png`.",
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            },
            "sourceUrl": {
              "description": "https URL we fetch the input from. Rejected before any charge if it is not https, is an IP literal, or resolves to a localhost/.internal/.local name; redirects are followed (max 3) and every hop is re-checked. We fetch from datacenter IP ranges - hosts that block datacenter egress will fail with `ingest_failed`, so prefer a presigned URL from storage you control. Body size cap: 100 MiB by default, enforced while streaming.",
              "examples": [
                "https://storage.example.com/clip.mov?signature=abc123"
              ],
              "format": "uri",
              "type": "string"
            },
            "startTime": {
              "description": "Window start in seconds (0 = from the beginning). Applies to every mode.",
              "minimum": 0,
              "type": "number"
            },
            "timestamps": {
              "description": "`timestamps` only: seconds into the source, one accurate frame each. Sorted for you. A timestamp at or past the end of the media fails the job.",
              "examples": [
                [
                  1.5,
                  30,
                  90.25
                ]
              ],
              "items": {
                "min

This page as JSON