v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Video Emotion API

Update Highlight Video

Generate custom highlight video using user-defined time segments.

Creates a highlight reel by concatenating specific video segments chosen by the user. The process runs asynchronously via Celery workers to handle video processing.

Args: video_id: The unique video ID for which highlights are being generated segments: List of time segments with start_millis and end_millis timestamps user_info: Authenticated user information

Returns: HighlightGenerateResponse: Contains video_id, status="queue", and processing message

Raises: InvalidParams: If segments list is empty InvalidUser: If user doesn't own the video UserVideoException: If segment timestamps are invalid: - Both start and end are 0 - Start equals end - Start is greater than or equal to end - Timestamps are out of video duration bounds 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.

put/v1/videos/{video_id}/highlights

Path parameters

video_idstring required

The unique video id of the video for which the update highlight video to be edited.

The unique video id of the video for which the update highlight video to be edited.

Request body

start_millisnumber required
end_millisnumber required

Response

Successful Response

video_idstring required
messagestring required
statusstring required