{"uid":"cap_fBM8yshZzdD2pfLeFKIPn","slug":"ffpipe-media-probe-0b4341e9","name":"ffpipe Media Probe","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.","url":"https://ffpipe.dev/v1/probe?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","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."}}},"responseSchema":{"type":"json","example":{"jobId":"6f1e28d4-3b52-4d0a-9c1f-2ab5cbe2f9c3","status":"queued","statusUrl":"https://ffpipe.example/v1/jobs/6f1e28d4-3b52-4d0a-9c1f-2ab5cbe2f9c3?t=9a1b2c3d4e5f60718293a4b5c6d7e8f9"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1qMwKJAsPq0nxs1du1yUE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Inspect any media file and return normalized technical metadata including container, codecs, dimensions, frame rate, HDR, and audio details, plus raw ffprobe output in multiple formats","exampleAgentPrompt":"Can you probe this video file and tell me the codec, display resolution, frame rate, and whether it's HDR? Here's the URL: https://storage.example.com/clip.mov","exampleUseCases":[{"title":"Video pipeline pre-flight check","prompt":"Before we transcode this upload, can you probe it and tell me the container format, video codec, display dimensions with any rotation, and frame rate? The file is at https://cdn.example.com/raw/upload_abc.mkv"},{"title":"Audio track validation for broadcast","prompt":"I need to verify the audio specs on this media file — specifically the number of channels and sample rate — to make sure it meets our broadcast requirements. Please probe https://media.example.com/master_audio.mp4"},{"title":"Diagnosing a corrupted media file","prompt":"This video file won't play and I need to know why. Can you run a probe on https://storage.example.com/broken_clip.avi and tell me what the analysis says about why it can't be decoded?"}],"resultDescription":"Returns a job ID and status URL immediately (202/queued). Once complete, the result includes a normalized ffpipe_summary block with container, duration, video codec, coded and display dimensions, rotation, frame rate as a number, HDR flag, audio codec, channels, and sample rate — plus the full raw ffprobe output in the requested format (JSON, XML, CSV, flat, or INI). Results are downloadable for 24 hours.","failureModes":["sourceUrl is not HTTPS or resolves to a private/localhost IP — rejected before charge with 400","File exceeds 100 MiB cap — rejected before charge","Host blocks datacenter egress — returns ingest_failed error","More than 3 redirects followed — ingestion fails","Upload window expires without PUT — terminal error state, no refund","Unknown section name in sections array — returns 400, not charged","File cannot be decoded — still returns a result with diagnosis of the failure reason"],"whenToPreferThis":"Use ffpipe Probe when you need accurate, normalized technical metadata for any media file — especially when you need coded vs. display dimensions, rotation, exact fps, or HDR detection without hand-rolling ffprobe parsing. It is also the right choice when you have a presigned URL for a file in cloud storage and want a one-call, no-account-needed inspection at a flat $0.01 USDC per probe. Prefer this over self-hosted ffprobe when you lack infrastructure, or over generic file metadata services when you need video/audio codec-level detail.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-07T21:21:38.689Z","lastSuccessfullyRanAt":"2026-09-07T21:21:38.689Z","lastHealthCheckAt":"2026-10-11T00:33:56.542Z","isFirstParty":false,"canonicalSlug":"ffpipe-media-probe-0b4341e9"}