medien.halowerk.com

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "docs": "https://medien.halowerk.com/llms.txt",
  "name": "keyframes",
  "error": "payment_required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "asset": "USDC",
        "version": "2",
        "eip712Domain": {
          "name": "USD Coin",
          "chainId": 8453,
          "version": "2",
          "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        },
        "network_name": "Base Mainnet",
        "assetTransferMethod": "eip3009"
      },
      "payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
      "amount": "10000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 300
    }
  ],
  "pricing": "https://medien.halowerk.com/pricing",
  "resource": {
    "url": "https://medien.halowerk.com/v1/keyframes",
    "mimeType": "application/json",
    "description": "Takes a video by URL or inline base64 and reports where the picture changes. FFmpeg measures the difference between consecutive frames; every jump above the threshold starts a new scene, and the answer lists each scene with start, end, duration and the fraction of the running time it covers, plus the raw detection score positions."
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "source": {
              "url": "https://example.com/film.mp4"
            },
            "scene_threshold": 0.35,
            "duration_minutes": 3,
            "include_thumbnails": true
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        }
      },
      "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": {
                "type": "object",
                "required": [
                  "source"
                ],
                "properties": {
                  "source": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": "string",
                        "maxLength": 2048,
                        "description": "Public http(s) URL of the video."
                      },
                      "filename": {
                        "type": "string",
                        "maxLength": 260
                      },
                      "content_base64": {
                        "type": "string",
                        "maxLength": 12000000,
                        "description": "The video inline, base64. Larger files must come by url."
                      }
                    },
                    "description": "The video. Either url or content_base64.",
                    "additionalProperties": false
                  },
                  "max_scenes": {
                    "type": "integer",
                    "default": 100,
                    "maximum": 400,
                    "minimum": 1,
                    "description": "Ceiling on returned scenes. What is dropped is counted and reported."
                  },
                  "max_thumbnails": {
                    "type": "integer",
                    "default": 20,
                    "maximum": 60,
                    "minimum": 1,
                    "description": "Ceiling on rendered thumbnails, independent of the scene count."
                  },
                  "scene_threshold": {
                    "type": "number",
                    "default": 0.35,
                    "maximum": 0.95,
                    "minimum": 0.05,
                    "description": "Frame-to-frame difference above which a new scene starts. Lower finds more, higher finds fewer."
                  },
                  "thumbnail_width": {
                    "type": "integer",
                    "default": 160,
                    "maximum": 640,
                    "minimum": 32,
                    "description": "Width of the thumbnails; height follows the aspect ratio."
                  },
                  "duration_minutes": {
                    "type": "integer",
                    "default": 1,
                    "maximum": 30,
                    "minimum": 1,
                    "description": "Length of the video in started minutes — this is what you are billed for. A longer video is refused with its real duration and nothing is charged; a shorter one simply costs what you declared, and the answer says how much less it would have been."
                  },
                  "min_scene_seconds": {
                    "type": "number",
                    "default": 0.4,
                    "maximum": 60,
                    "minimum": 0,
                    "description": "Merge cuts closer together than this. Guards against flicker being read as a cut."
                  },
                  "include_thumbnails": {
                    "type": "boolean",
                    "default": false,
                    "description": "Render one JPEG per scene and return it base64."
                  }
                },
                "additionalProperties": false
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  },
  "price_usdc": "0.010000",
  "description": "Takes a video by URL or inline base64 and reports where the picture changes. FFmpeg measures the difference between consecutive frames; every jump above the threshold starts a new scene, and the answer lists each scene with start, end, duration and the fraction of the running time it covers, plus the raw detection score positions. A thumbnail can be rendered per scene, sampled a little after the cut rather than exactly on it because the frame on the cut is often a transition, and returned as base64 JPEG at a width you choose. Media facts come from ffprobe: duration, container, codec, resolution, frame rate and whether there is audio. The threshold is the whole game and is therefore exposed and reported back: at 0.2 a slow pan becomes several scenes, at 0.6 a hard cut between similar shots is missed, and 0.3 to 0.4 suits most edited material — no threshold is correct for all footage, and the endpoint does not pretend otherwise. What it does not do is understand the video: it detects visual discontinuity, so a lighting change or a camera flash counts as a scene change and a cut between two similar shots does not, and it neither recognises objects nor reads the audio. Billing is per started minute, and because the price has to be fixed before the file is even fetched, the caller declares the length: if the video turns out longer than declared, the call is refused with the real duration and nothing is charged.",
  "inputSchema": {
    "type": "object",
    "required": [
      "source"
    ],
    "properties": {
      "source": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "description": "Public http(s) URL of the video."
          },
          "filename": {
            "type": "string",
            "maxLength": 260
          },
          "content_base64": {
            "type": "string",
            "maxLength": 12000000,
            "description": "The video inline, base64. Larger files must come by url."
          }
        },
        "description": "The video. Either url or content_base64.",
        "additionalProperties": false
      },
      "max_scenes": {
        "type": "integer",
        "default": 100,
        "maximum": 400,
        "minimum": 1,
        "description": "Ceiling on returned scenes. What is dropped is counted and reported."
      },
      "max_thumbnails": {
        "type": "integer",
        "default": 20,
        "maximum": 60,
        "minimum": 1,
        "description": "Ceiling on rendered thumbnails, independent of the scene count."
      },
      "scene_threshold": {
        "type": "number",
        "default": 0.35,
        "maximum": 0.95,
        "minimum": 0.05,
        "description": "Frame-to-frame difference above which a new scene starts. Lower finds more, higher finds fewer."
      },
      "thumbnail_width": {
        "type": "integer",
        "default": 160,
        "maximum": 640,
        "minimum": 32,
        "description": "Width of the thumbnails; height follows the aspect ratio."
      },
      "duration_minutes": {
        "type": "integer",
        "default": 1,
        "maximum": 30,
        "minimum": 1,
        "description": "Length of the video in started minutes — this is what you are billed for. A longer video is refused with its real duration and nothing is charged; a shorter one simply costs what you declared, and the answer says how much less it would have been."
      },
      "min_scene_seconds": {
        "type": "number",
        "default": 0.4,
        "maximum": 60,
        "minimum": 0,
        "description": "Merge cuts closer together than this. Guards against flicker being read as a cut."
      },
      "include_thumbnails": {
        "type": "boolean",
        "default": false,
        "description": "Render one JPEG per scene and return it base64."
      }
    },
    "additionalProperties": false
  },
  "price_basis": {
    "unit": "minute",
    "basis": "duration_minutes aus der Anfrage, aufgerundet. Ist das Video laenger, wird abgelehnt und nichts abgebucht.",
    "units": 1
  },
  "price_model": {
    "kind": "per_unit",
    "unit": "minute",
    "max_usdc": "0.30",
    "min_usdc": "0.01",
    "max_units": 30,
    "unit_price_usdc": "0.01"
  },
  "x402Version": 2,
  "instructions": "Sign the accepted terms with an x402 client and repeat the request with the payment header.",
  "payment_header": "PAYMENT-SIGNATURE",
  "capability_request": {
    "url": "https://bedarf.halowerk.com/capabilities/request",
    "cost": "free",
    "method": "POST",
    "description": "Missing a capability, or does the scope not fit? Report the need here - no payment required. Similar reports are bundled; the response returns an id you can check back on.",
    "body_example": {
      "max_price": 0.01,
      "description": "what exactly is needed",
      "requested_capability": "short label"
    }
  }
}

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",
      "asset": "USDC",
      "version": "2",
      "eip712Domain": {
        "name": "USD Coin",
        "chainId": 8453,
        "version": "2",
        "verifyingContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      },
      "network_name": "Base Mainnet",
      "assetTransferMethod": "eip3009"
    },
    "payTo": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
    "amount": "30000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "source": {
            "url": "https://example.com/film.mp4"
          },
          "scene_threshold": 0.35,
          "duration_minutes": 3,
          "include_thumbnails": true
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      }
    },
    "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": {
              "type": "object",
              "required": [
                "source"
              ],
              "properties": {
                "source": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "Public http(s) URL of the video."
                    },
                    "filename": {
                      "type": "string",
                      "maxLength": 260
                    },
                    "content_base64": {
                      "type": "string",
                      "maxLength": 12000000,
                      "description": "The video inline, base64. Larger files must come by url."
                    }
                  },
                  "description": "The video. Either url or content_base64.",
                  "additionalProperties": false
                },
                "max_scenes": {
                  "type": "integer",
                  "default": 100,
                  "maximum": 400,
                  "minimum": 1,
                  "description": "Ceiling on returned scenes. What is dropped is counted and reported."
                },
                "max_thumbnails": {
                  "type": "integer",
                  "default": 20,
                  "maximum": 60,
                  "minimum": 1,
                  "description": "Ceiling on rendered thumbnails, independent of the scene count."
                },
                "scene_threshold": {
                  "type": "number",
                  "default": 0.35,
                  "maximum": 0.95,
                  "minimum": 0.05,
                  "description": "Frame-to-frame difference above which a new scene starts. Lower finds more, higher finds fewer."
                },
                "thumbnail_width": {
                  "type": "integer",
                  "default": 160,
                  "maximum": 640,
                  "minimum": 32,
                  "description": "Width of the thumbnails; height follows the aspect ratio."
                },
                "duration_minutes": {
                  "type": "integer",
                  "default": 1,
                  "maximum": 30,
                  "minimum": 1,
                  "description": "Length of the video in started minutes — this is what you are billed for. A longer video is refused with its real duration and nothing is charged; a shorter one simply costs what you declared, and the answer says how much less it would have been."
                },
                "min_scene_seconds": {
                  "type": "number",
                  "default": 0.4,
                  "maximum": 60,
                  "minimum": 0,
                  "description": "Merge cuts closer together than this. Guards against flicker being read as a cut."
                },
                "include_thumbnails": {
                  "type": "boolean",
                  "default": false,
                  "description": "Render one JPEG per scene and return it base64."
                }
              },
              "additionalProperties": false
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-09-21 09:59Z

Last indexed by Roundhouse

2026-09-25 06:00Z

Last enriched (probe, favicon, geo)

2026-09-21 04:45Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 400