Command · Find Subjects
analysis.subjects
Finds the faces, people and salient regions of a media item over time, shot by shot (5-10 samples a second, denser while the picture moves; faces and people tracked within each shot).
- v1
- Capability MediaAnalysis
- Tool
analysis_subjects
Request
{
"command": "analysis.subjects",
"params": {
"media": 1
}
}Parameters
mediainteger | string (1..)Required- Media id or exact name.
streaminteger (0..15)- Video stream index (default 0).
Discussion
Finds the faces, people and salient regions of a media item over time, shot by shot (5-10 samples a second, denser while the picture moves; faces and people tracked within each shot). Reframing uses it; the result is cached per file, so running it again is cheap. Runs locally: nothing leaves the computer.
Run it with wabcut-cli cmd <project> --json, from an MCP client as analysis_subjects, or from an extension. See Edit commands for requests, references and results.
See also
analysis.*
- analysis.detectBeats
Detect Beats. Finds the tempo and beats of a clip's music: beat markers labelled 1-2-3-4 (downbeats red) and the sequence's beat grid (snapping, edit.snapToBeats and edit.cutToBeats use it).
- analysis.detectShots
Detect Shots. Finds the cuts (hard cuts, fades through black, dissolves; flashes are not cuts) in a clip's video and, for a clip, marks them with sequence markers ("markers": false to only list them).
- analysis.speakers
Who Speaks When. Active-speaker detection for a multicam source, on this computer: who speaks when (with crosstalk, silence and laughter) and which angle shows whom (close-up or wide), from the transcripts with their speakers, each angle's microphone level and each camera's faces and lip motion.