# halowerk Medien Scene Detection

> halowerk Medien Scene Detection is a paid API for AI agents from medien.halowerk.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Analyzes a video (by URL or base64) using FFmpeg frame-difference analysis to detect scene boundaries and return timestamps, durations, and detection scores for each scene.

## Facts

- Endpoint: POST https://medien.halowerk.com/v1/keyframes
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-medien-scene-detection-132f6ee3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fH6ZXPhagN8sk4Qz9HHgt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-medien-scene-detection-132f6ee3 -d '<json body>'
```

Example prompt: Can you detect all the scene changes in this video — https://example.com/myvideo.mp4 — and tell me when each scene starts and ends, how long it lasts, and what fraction of the total runtime it covers?

## When to prefer this

Choose this endpoint when you need timestamped scene boundary data from a video, especially when you want FFmpeg-level precision with raw detection scores. Prefer this over manual frame extraction when you need the full list of scene segments with duration fractions in a single call. Best suited for workflows that chapter-mark, summarize, or segment video content automatically.

## Known failure modes

- Video URL is inaccessible or returns a non-200 response
- Base64 payload is malformed or not a valid video format
- Video is too short or has no detectable scene changes — returns empty scene list
- Threshold parameter set too high causing all cuts to be missed
- Threshold parameter set too low causing noise to be detected as scenes
- Unsupported video codec or container format
- Network timeout for large remote video files

## How this service works

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.

## Output

A list of detected scenes, each with its start time, end time, duration, fraction of total video runtime, and raw FFmpeg frame-difference detection score at that boundary point.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-medien-scene-detection-132f6ee3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from medien.halowerk.com](https://www.zero.xyz/host/medien.halowerk.com/llms.txt)