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.

BEFORE / AFTER

See what the tool changes.

A real example: the after side is the unedited output of a KinoPipe job. Run the live form above to generate the same result from your own media.

BeforeSource video

WebM · VP9

mountain.webm

AfterCompatible MP4

Ready

MP4 · H.264

mountain.mp4

Demo footage: public-domain timelapses (Bureau of Land Management, Oregon · NASA SVS). Processed by the same pipeline the API and MCP tools call.

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

What does the blur score mean?

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.

How do I use the result?

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.

Related media tools

View all tools

Detect Scene Changes in a Video

List the timestamps where the picture cuts to a new scene, then pick trim, split and clip boundaries from real cuts.

Explore

Trim Video with an API

Cut a precise segment from a source video using start and end times.

Explore

Split Video into Equal Parts by API

Divide one video into independently playable MP4 segments of a chosen duration.

Explore