All toolsdetect blurry video segments API

Detect Blurry, Black and Frozen Passages

List the blurry, black and frozen passages of a video with start, end and duration, so an agent can trim them before editing without watching the footage. Run the preset directly on this page or call the same agent-ready endpoint from your product.

Run this tool View API recipe

LIVE TOOL

Run detect visual issues

Drop a video, adjust the defaults if you need to, and download the result here.

Useful defaults, typed options.

The tool slug stays stable while your agent supplies named media inputs and a narrow set of documented options.

No encode, analysis only
Blur threshold and minimum duration control
Per-second sharpness series included

What this preset does

01Sample the video at 4 fps and 360p
02Measure edge sharpness on every sampled frame
03Flag black and frozen frames
04Group passages above the minimum duration and return them as JSON

Stable endpointPOST /api/v1/tools/detect-visual-issues

Live API request

Synced with form

{
  "inputs": [{ "id": "main", "url": "https://example.com/family-video.mp4" }],
  "options": { "blur_threshold": 10, "min_duration": 1 }
}

Successful output example

{
  "result": {
    "output": {
      "filename": "detect-visual-issues-output.mp4",
      "contentType": "video/mp4",
      "byteSize": 437021,
      "downloadUrl": "https://cdn.kinopipe.com/…"
    }
  }
}

Know the boundaries before you run.

Blur is the average edge width in pixels at 360p: sharp footage scores around 5, soft or out-of-focus footage above 10.

Black frames have no blur score, and a frozen passage inside a black passage is reported once, as black.

About detect visual issues

The average width of the edges in the frame, in pixels, after scaling to 360p. Sharp footage sits around 5; the default threshold of 10 flags clearly soft frames. Lower it to be stricter, raise it for footage that is soft by design.

Feed the passages to trim-video or split-video: cut the blurry opening, drop the black gap, skip the frozen ending. Pair it with detect-scenes to cut on real scene changes.