---
title: "Process Highlight"
method: POST
path: "/v1/videos/highlights"
tags: ["Video Emotion API"]
---

# Process Highlight

`POST /v1/videos/highlights`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v1/videos/highlights`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Trigger automatic highlight video generation using emotion-based analysis.

Analyzes video frames to identify emotionally significant moments and generates
a highlight reel. The process runs asynchronously.

Args:
    video_id: The unique video ID for highlight generation
    user_info: Authenticated user information
    api_info: API request metadata including domain

Returns:
    HighlightGenerateResponse: Contains video_id, processing status, and message
    
Raises:
    InvalidParams: If video_id is missing
    InvalidUser: If user doesn't own the video
    CreditExpired: If user has insufficient credits
    VideoNotFound: If video doesn't exist or is not completed

Credit Usage:
    10 credits per minute of video duration.
    Enterprise plans: 5 credits per minute.
    First use is free (feature credit).

## Request body `application/x-www-form-urlencoded`

- BodyProcessHighlightV1VideosHighlightsPost
  - `video_id` string, required: The unique video ID of the video for which the highlight to be generated.

## Response `200`

Successful Response

- HighlightGenerateResponse: Model for highlight video generation trigger response. Attributes: video_id (str): The video ID for which highlights are being generated. message (str): Status message about the highlight generation process. status (str): Current status of highlight generation (queue, processing, completed, failed).
  - `video_id` string, required
  - `message` string, required
  - `status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)