Get face detection results
get_face_detection_resultsReturns a face-detection job's status and detected faces. Use with the id from detect_faces to inspect progress and choose face mappings before a selected-face swap. Read-only; faces may populate while processing.
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": {
"id": "<id>"
},
"name": "get_face_detection_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The id of the task. This value is returned by the [face detection API](https://docs.magichour.ai/api-reference/files/face-detection#response-id). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The id of the task. This value is returned by the [face detection API](https://docs.magichour.ai/api-reference/files/face-detection#response-id). | |
| error | Yes | Why the face detection failed. Present only when `status` is `error`; `null` otherwise. | |
| faces | Yes | The faces detected in the image or video. The list is populated as faces are detected. | |
| status | Yes | The status of the detection. | |
| credits_charged | Yes | The credits charged for the task. |