---
title: "Trigger Personality Analysis"
method: POST
path: "/v2/videos/{video_id}/personality/analyze"
tags: ["Video Emotion API"]
---

# Trigger Personality Analysis

`POST /v2/videos/{video_id}/personality/analyze`

Trigger personality analysis for a specific face in a video.

Initiates asynchronous personality trait assessment based on facial expressions and,
when available, vocal characteristics from linked audio speaker data.

## Analysis Types

- **overall**: Analyzes personality traits across the entire video
- **by_segment**: Analyzes personality traits by time segments
- **combined**: Performs both overall and segment analysis

Overall and segment analyses are independent - triggering one does not affect the other.

## Multimodal Analysis

- **Face only**: Analyzes facial expressions when no speaker is linked
- **Face + Audio**: Combines facial and vocal characteristics when face is linked to a speaker

## Prerequisites

- Video must be completed
- Face ID must exist in the video
- If face has speaker mapping: audio must be completed
- User must have sufficient credits

## Request

```json
{
  "face_id": 1,
  "analysis_type": "overall",
  "callback_url": "https://example.com/webhook"
}
```

## Response

```json
{
  "video_id": "abc123",
  "face_id": 1,
  "speaker_id": 2,
  "analysis_type": "overall",
  "status": "processing",
  "message": "Personality analysis triggered successfully"
}
```

## Credit Usage

Credits are billed per minute of video duration based on `analysis_type`.

| analysis_type | Personal | Professional & Enterprise |
|---|---|---|
| overall | 30 credits/min | 15 credits/min |
| by_segment | 50 credits/min | 25 credits/min |
| combined | 60 credits/min | 30 credits/min |

## Notes

- Analysis runs asynchronously in the background
- Use callback_url for webhook notifications when complete
- Credits are deducted when analysis is triggered
- Retrieve results using the video analytics endpoints

## Path parameters

- `video_id` string, required — Unique identifier of the video. Video must be in 'completed' status with detected faces.

## Response `200`

Successful Response

- PersonalityTriggerResponse — Response model returned after triggering personality processing for a specific face (and optionally a speaker) within a video. Attributes: video_id (str): Unique identifier of the video where personality processing was triggered. face_id (int): Identifier of the face entity associated with the personality trigger. speaker_id (Optional[int]): Identifier of the linked speaker entity, if applicable; otherwise None. analysis_type (str): Type of personality analysis - 'overall', 'by_segment', or 'combined'. status (str): Result status of the trigger operation message (str): Status message describing the result of the trigger operation.
  - `video_id` string, required
  - `face_id` integer, required
  - `speaker_id` integer, nullable
  - `analysis_type` string, required
  - `status` string, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/350e9cbcb623/schema)