ffpipe

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d",
    "amount": "10000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

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."
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-09-22 15:33Z

Last indexed by Roundhouse

2026-09-24 19:30Z

Last enriched (probe, favicon, geo)

2026-09-23 00:45Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 404