{"api":"v1","generated_at":"2026-09-15T22:51:41.552Z","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-probe-f84fb3","pinned_page":"https://tollindex.com/e/ffpipe-dev-v1-probe-f84fb3/at/2026-09-15T21-20Z","pinned":false,"method":"https://tollindex.com/ledger/method","snapshot_at":"2026-09-15T21:20:12.737Z","snapshot_stamp":"2026-09-15T21-20Z","endpoint":{"slug":"ffpipe-dev-v1-probe-f84fb3","canonical_url":"https://ffpipe.dev/v1/probe","resource":"https://ffpipe.dev/v1/probe","http_method":"POST","type":"http","x402_version":2,"registries":["cdp"],"primary_registry":"cdp","curated_by_coinbase":false,"description":"Inspect any media file and get its technical metadata. Container, duration, codecs, DISPLAY dimensions and rotation, frame rate, HDR, audio channels and sample rate, in a normalized summary plus the full raw analysis (JSON, XML, CSV, flat or INI). Provide a source URL or upload the file directly; the result is downloadable for 24 hours. A file that cannot be decoded still answers with the diagnosis of why. Fixed price per probe 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-15T01:55:36.312Z"},"derived":{"note":"fields no registry supplies; TOLL derives them and marks them derived on the page","title":"probe","category":"storage","first_observed_by_toll":"2026-09-10T19:08:24.178Z","last_observed_by_toll":"2026-09-15T21:20:12.737Z","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-15T21:20:12.737Z","calls_30d":5,"unique_payers_30d":3,"last_called_at":"2026-09-15T01:55:35.455Z"},"validation":{"latest":{"observed_at":"2026-09-15T07:05:11.104Z","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:05:11.104Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-15","state_changed":false},{"observed_at":"2026-09-14T06:31:29.373Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-14","state_changed":false},{"observed_at":"2026-09-13T06:20:45.709Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-13","state_changed":false},{"observed_at":"2026-09-12T10:29:51.508Z","state":"pass","failed_checks":[],"run_id":"daily-2026-09-12","state_changed":false},{"observed_at":"2026-09-11T14:50:11.381Z","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-15T01:55:35.455Z","l30DaysTotalCalls":5,"l30DaysUniquePayers":3},"resource":"https://ffpipe.dev/v1/probe","extensions":{"bazaar":{"info":{"input":{"body":{"sourceUrl":"https://storage.example.com/clip.mov?signature=abc123"},"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"]}],"properties":{"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`."},"summary":{"type":"boolean","default":true,"description":"Keep the normalized `ffpipe_summary` block (JSON only). Send false for byte-exact raw output. PREFER the summary: it answers coded-vs-display dimensions, rotation, fps as a number and HDR directly, which is where hand-rolled parsing of the raw sections usually goes wrong."},"sections":{"type":"array","items":{"enum":["format","streams","chapters","programs"],"type":"string"},"default":["format","streams","chapters"],"description":"Which sections to report. Defaults to format + streams + chapters. Duplicates are collapsed; an unknown name is a 400 (never charged)."},"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."},"showFrames":{"type":"boolean","default":false,"description":"Report per-FRAME detail. Large: unless you also send `readIntervals`, a bounded window is applied for you so the analysis cannot outgrow what we can deliver. Combine with `showEntries` to keep only the fields you need."},"countFrames":{"type":"boolean","default":false,"description":"Count frames exactly, which requires decoding the whole file - slow on long sources. Leave it off unless an exact count is the point."},"showEntries":{"type":"string","examples":["frame=pict_type,pts_time,key_frame"],"maxLength":256,"description":"Keep only the named fields, e.g. `frame=pict_type,pts_time,key_frame` or `format=duration`. Section and field names only; a malformed expression is a 400 (never charged) rather than a job that cannot succeed."},"showPackets":{"type":"boolean","default":false,"description":"Report per-PACKET detail. Same bounded-window treatment as `showFrames`."},"countPackets":{"type":"boolean","default":false,"description":"Count packets exactly. Same cost caveat as `countFrames`."},"outputFormat":{"enum":["json","xml","csv","flat","ini"],"type":"string","default":"json","description":"Format of the delivered analysis. `json` (the default) is the only one that carries the normalized `ffpipe_summary` block; the others are the raw writer output, untouched. `flat` is delivered as .txt."},"readIntervals":{"type":"string","examples":["%+60"],"maxLength":256,"description":"Limit the analysis to a window, e.g. `%+60` (the first 60 seconds), `30%+10` (10 seconds from 0:30) or `%+#500` (the first 500 packets). Applied automatically when frame/packet detail is requested without one. A malformed expression is a 400 (never charged)."},"selectStreams":{"type":"string","examples":["v:0"],"maxLength":256,"description":"Restrict the analysis to matching streams, e.g. `v:0` (first video stream) or `a` (all audio). A specifier that matches nothing still succeeds and says so."}},"description":"Provide EXACTLY ONE of sourceUrl (we fetch it) or upload: true (you PUT the bytes to the uploadUrl returned in the 202). Everything else is optional: the defaults return the full analysis as JSON with a normalized summary block. Numbers and booleans must be JSON numbers/booleans, not strings. 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":"Inspect any media file and get its technical metadata. Container, duration, codecs, DISPLAY dimensions and rotation, frame rate, HDR, audio channels and sample rate, in a normalized summary plus the full raw analysis (JSON, XML, CSV, flat or INI). Provide a source URL or upload the file directly; the result is downloadable for 24 hours. A file that cannot be decoded still answers with the diagnosis of why. Fixed price per probe in USDC over x402; no account or API key. Input up to 100 MB.","lastUpdated":"2026-09-15T01:55:36.312Z","serviceName":"ffpipe","x402Version":2}]}}