# HALOWERK Video Quality Detector (Black/Freeze/Silence)

> HALOWERK Video Quality Detector (Black/Freeze/Silence) is a paid API for AI agents from medien.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-31).

Analyzes a video file in a single pass to detect black frames, frozen frames, and audio silence segments, with configurable thresholds, and returns a pass/fail quality summary.

## Facts

- Endpoint: POST https://medien.halowerk.com/v1/video-black-detect?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-video-quality-detector-black-freeze-silence-fcb05c29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RR3YdO0TXPy1fyUpecWFF

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-video-quality-detector-black-freeze-silence-fcb05c29 -d '<json body>'
```

Example prompt: Can you scan this video file for any black frames, frozen frames, or silent audio sections — flag anything longer than 1 second of black, 3 seconds of freeze, or 3 seconds of silence, and tell me if the file passes quality check? The video is at https://example.com/myvideo.mp4 and it's about 10 minutes long.

## When to prefer this

Choose this endpoint when you need a single-pass, multi-defect video quality check combining black frame detection, freeze detection, and silence detection in one call. It is ideal for broadcast QC pipelines, VOD ingest validation, and archive auditing where privacy matters — all processing is local and no data leaves the server. Prefer it over separate per-defect tools when you want a unified pass/fail verdict and need leading/trailing black distinguished from mid-content black.

## Known failure modes

- Video URL is unreachable or returns a non-video content type
- Base64 payload exceeds the 12 MB limit
- Video duration exceeds 30 minutes
- Threshold parameters out of allowed ranges (e.g. silence_db above -20 or below -90)
- Corrupted or unsupported video codec that ffmpeg cannot process
- Network timeout fetching video from remote URL

## How this service works

Takes a video of up to 30 minutes and finds, in one pass, segments where the picture is black (blackdetect), where it freezes (freezedetect) and where the sound drops out (silencedetect), each with start, end and duration, using minimum lengths and thresholds you can set. A summary says whether the file passes with no finding longer than the limits. Leading and trailing black is reported separately because it is often intended. Runs locally with ffmpeg; nothing leaves this machine.

## Output

Returns a structured report listing all detected black segments, frozen frame segments, and silence segments — each with start time, end time, and duration. Leading and trailing black sections are reported separately. Includes an overall pass/fail summary indicating whether any finding exceeds the configured minimum-length thresholds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "source": {
   "type": "object",
   "properties": {
    "url": {
     "type": "string",
     "maxLength": 2048
    },
    "filename": {
     "type": "string",
     "maxLength": 260
    },
    "content_base64": {
     "type": "string",
     "maxLength": 12000000
    }
   },
   "additionalProperties": false
  },
  "silence_db": {
   "type": "number",
   "default": -50,
   "maximum": -20,
   "minimum": -90
  },
  "duration_minutes": {
   "type": "integer",
   "maximum": 30,
   "minimum": 1
  },
  "min_black_seconds": {
   "type": "number",
   "default": 0.5,
   "maximum": 10,
   "minimum": 0.04
  },
  "min_freeze_seconds": {
   "type": "number",
   "default": 2,
   "maximum": 60,
   "minimum": 0.5
  },
  "min_silence_seconds": {
   "type": "number",
   "default": 2,
   "maximum": 60,
   "minimum": 0.2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-video-quality-detector-black-freeze-silence-fcb05c29/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)