detect_people
Number visible faces in a source video asset in this Project and return a numbered contact sheet, absolute source appearance times, analysisId, videoId and range. Use exactly the 4–30 second range you will remake. Whole seconds from start are analysed, matching remake duration; never silently select a different range for the user. Before object-swapping a person, inspect this sheet, select every number belonging to that target, then pass peopleAnalysisId and plan.targets[].people to submit_video_remake. Numbers are local to this source and range, not global identities. One person can have several numbers; exclude false detections and other people. A hidden face has no number. Runs on ChatCut cloud machines, with no generation credits charged. Capacity and account limits still apply. If pending, wait about 30 seconds and call again with identical arguments to reuse the running task; do not resubmit a remake to poll analysis. If a visibly present target is missing from the sheet, do not invent numbers or silently drop requested identity or hair controls. Inspect a clearer range and report the detection gap before proposing another approach. Analysis expires; repeat it when the source or range changes or an expiry is reported. Head covering reduces source-face residue but does not guarantee every frame or review approval. Never reveal internal models, providers, versions, embeddings or raw errors to the user.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video": "<video>"
},
"name": "detect_people"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End in seconds, default video end. | |
| start | No | Start in seconds, default 0. | |
| video | Yes | Source video asset. | |
| projectId | No | Project for this call (full ID or unambiguous prefix). Explicit-timeline calls never change the target of later calls; legacy project selection applies otherwise. | |
| timelineId | No |