ffpipe

Endpoints and prices

Payment evidence

402 payload captured at 2026-09-07 04:03:22 UTC. Check evidence JSON · Measurement methodology.

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x38c72cAb5d8F053a7CCE4F522b923C3c70291B9d",
      "amount": "20000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 300
    }
  ],
  "resource": {
    "url": "https://ffpipe.dev/v1/convert",
    "tags": [
      "video",
      "convert",
      "mp4",
      "media",
      "ffmpeg"
    ],
    "mimeType": "application/json",
    "description": "Convert any video to a clean, web-ready MP4. Provide a source URL or upload the file directly; the paid request returns a status URL to poll, and the finished MP4 (plus a thumbnail) is downloadable for 24 hours. Fixed price per conversion in USDC over x402; no account or API key. Failures on our side automatically mint a free retry voucher. Input up to 100 MB.",
    "serviceName": "ffpipe"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "maxWidth": 1280,
            "maxHeight": 720,
            "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`."
                  },
                  "maxWidth": {
                    "type": "integer",
                    "default": 1920,
                    "maximum": 4096,
                    "minimum": 1,
                    "description": "Max output width. Must be a positive integer (JSON number, not a string)."
                  },
                  "maxHeight": {
                    "type": "integer",
                    "default": 1080,
                    "maximum": 4096,
                    "minimum": 1,
                    "description": "Max output height."
                  },
                  "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."
                  }
                },
                "description": "Provide EXACTLY ONE of sourceUrl (we fetch it) or upload: true (you PUT the bytes to the uploadUrl returned in the 202). 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."
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}