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

# Process Highlight

`POST /v1/videos/highlights`

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 via Celery workers.

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.
    Professional and Enterprise plans: 5 credits per minute.
    First use is free (feature credit).

## 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.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)