{"api":"v1","generated_at":"2026-09-15T19:45:00.104Z","licence":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"TOLL, with a link to the page cited"},"page":"https://tollindex.com/e/ffpipe-dev-v1-frames-f7ddca","pinned_page":"https://tollindex.com/e/ffpipe-dev-v1-frames-f7ddca/at/2026-09-15T16-57Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T16:57:44.360Z","snapshot_stamp":"2026-09-15T16-57Z","endpoint":{"slug":"ffpipe-dev-v1-frames-f7ddca","canonical_url":"https://ffpipe.dev/v1/frames","resource":"https://ffpipe.dev/v1/frames","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"description":"Extract still frames from any video as JPEG, WebP or PNG - built for feeding video to a vision model. Choose the sampling: every frame, every Nth, a fixed rate in seconds, keyframes only, N evenly spaced, or exact timestamps; optionally windowed and size-capped. Up to 1000 frames per job. The result is a manifest listing every frame with its timestamp and its own download URL, available for 24 hours. Fixed price per job in USDC over x402; no account or API key. Input up to 100 MB.","service_name":"ffpipe","declared_category":null,"declared_tags":["video","convert","mp4","media","ffmpeg"],"route_template":null,"registry_updated":"2026-09-07T21:21:54.843Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"frames","category":"compute","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T16:57:44.360Z","observation_began":"2026-09-10"},"presence":{"listed_now":true,"first_absent_at":null,"delisting_confirmed_at":null,"events":[{"registry":"cdp","at":"2026-09-10T19:08:24.178Z","event":"listed"}]},"accepts":[{"registry":"cdp","ordinal":0,"network":"eip155:8453","asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","asset_name":"USD Coin","symbol":"USDC","decimals":6,"amount_display":"0.01 USDC","amount_units":0.01,"decimals_known":true,"pay_to":"0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d","scheme":"exact"}],"counters":{"observed_at":"2026-09-15T16:57:44.360Z","calls_30d":2,"unique_payers_30d":2,"last_called_at":"2026-09-07T21:21:54.221Z"},"validation":{"latest":{"observed_at":"2026-09-15T07:04:45.237Z","state":"pass","failed_checks":[],"endpoint_http_status":402,"run_id":"daily-2026-09-15"},"uptime":[{"days":7,"observed":5,"passed":5,"ratio":1},{"days":30,"observed":5,"passed":5,"ratio":1},{"days":90,"observed":5,"passed":5,"ratio":1}],"history_90d":[{"observed_at":"2026-09-15T07:04:45.237Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T06:31:07.356Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T06:20:25.546Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T10:29:26.608Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T14:49:41.656Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-11","state_changed":true}]},"seller":{"wallet":"0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d","page":"https://tollindex.com/seller/0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d","endpoints":3,"hosts":1},"reports":0,"registry_record":{"cdp":[{"tags":["video","convert","mp4","media","ffmpeg"],"type":"http","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d","amount":"10000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300}],"quality":{"lastCalledAt":"2026-09-07T21:21:54.221Z","l30DaysTotalCalls":2,"l30DaysUniquePayers":2},"resource":"https://ffpipe.dev/v1/frames","extensions":{"bazaar":{"info":{"input":{"body":{"fps":1,"mode":"interval","sourceUrl":"https://storage.example.com/clip.mov?signature=abc123","maxOutputWidth":1280,"maxOutputHeight":720},"type":"http","method":"POST","bodyType":"json"},"output":{"type":"json","example":{"jobId":"6f1e28d4-3b52-4d0a-9c1f-2ab5cbe2f9c3","status":"queued","statusUrl":"https://ffpipe.example/v1/jobs/6f1e28d4-3b52-4d0a-9c1f-2ab5cbe2f9c3?t=9a1b2c3d4e5f60718293a4b5c6d7e8f9"}}},"schema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"oneOf":[{"required":["sourceUrl"]},{"required":["upload"]}],"required":["mode"],"properties":{"n":{"type":"integer","minimum":1,"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."},"fps":{"type":"number","maximum":120,"description":"`interval` only: frames per second, framerate-independent. May be below 1 - `0.5` is one frame every two seconds.","exclusiveMinimum":0},"mode":{"enum":["all","every_nth","interval","keyframes","evenly_spaced","timestamps"],"type":"string","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`."},"count":{"type":"integer","maximum":1000,"minimum":1,"description":"`evenly_spaced` only: how many frames to spread across the window."},"format":{"enum":["jpeg","jpg","webp","png"],"type":"string","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`."},"upload":{"type":"boolean","const":true,"description":"Push intake: instead of a `sourceUrl`, reserve an upload window and PUT the raw bytes (<= 100 MiB, same cap) to the `uploadUrl` in the 202 before `uploadExpiresAt`. You are charged at the 202, before any bytes move: letting the window expire is a terminal `error` with no refund; a pipeline failure after your upload earns a `retryVoucher`."},"endTime":{"type":"number","minimum":0,"description":"Window end in seconds (0 = to the end). Must be greater than `startTime`; past the end of the media it is clamped."},"quality":{"type":"integer","default":85,"maximum":100,"minimum":1,"description":"Encoder quality for `jpeg`/`webp`; ignored for the lossless `png`."},"maxFrames":{"type":"integer","default":1000,"maximum":1000,"minimum":1,"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."},"sourceUrl":{"type":"string","format":"uri","examples":["https://storage.example.com/clip.mov?signature=abc123"],"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."},"startTime":{"type":"number","minimum":0,"description":"Window start in seconds (0 = from the beginning). Applies to every mode."},"timestamps":{"type":"array","items":{"type":"number","minimum":0},"examples":[[1.5,30,90.25]],"maxItems":1000,"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."},"maxOutputWidth":{"type":"integer","maximum":4096,"minimum":0,"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."},"maxOutputHeight":{"type":"integer","maximum":4096,"minimum":0,"description":"Fit box height. Same rules as `maxOutputWidth`."}},"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.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["jobId","status","statusUrl"],"properties":{"jobId":{"type":"string","format":"uuid"},"status":{"enum":["queued","awaiting_upload"],"type":"string","description":"`queued` for pull mode; `awaiting_upload` for upload mode (the job queues when your PUT completes)."},"statusUrl":{"type":"string","format":"uri","description":"Free, token-gated status endpoint for this job. Keep it: the token is the only proof of ownership and is not recoverable."},"uploadUrl":{"type":"string","format":"uri","description":"Upload mode only: PUT the raw bytes here before `uploadExpiresAt`. Keep it - this response is the ONLY place the upload token is handed out (the status route never repeats it), and it is not recoverable."},"fundingSource":{"enum":["x402","credits","voucher"],"type":"string","description":"What paid for this acceptance: `x402` (the on-chain payment you signed), `credits` (your account's balance, when you sent a Bearer token) or `voucher` (a free retry). Stated back to you so a caller holding both a token and a wallet never has to guess which one it just spent."},"uploadExpiresAt":{"type":"string","format":"date-time","description":"Upload mode only: deadline for the PUT. Past it the job becomes a terminal `error` with no refund."}},"description":"The 202 acceptance body. Every non-2xx answer is JSON { error: { code, message } } with code one of: invalid_request, invalid_source_url, source_too_large, ingest_failed, pipeline_error, payment_denied, rate_limited, daily_cap_exceeded, not_found, literal_path_template, gone, unknown_job, unauthorized, not_configured, unavailable - and, by the capture rule, a non-2xx response is never charged."}}}}}}},"description":"Extract still frames from any video as JPEG, WebP or PNG - built for feeding video to a vision model. Choose the sampling: every frame, every Nth, a fixed rate in seconds, keyframes only, N evenly spaced, or exact timestamps; optionally windowed and size-capped. Up to 1000 frames per job. The result is a manifest listing every frame with its timestamp and its own download URL, available for 24 hours. Fixed price per job in USDC over x402; no account or API key. Input up to 100 MB.","lastUpdated":"2026-09-07T21:21:54.843Z","serviceName":"ffpipe","x402Version":2}]}}