v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Video Emotion API

Process Highlight

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

post/v1/videos/highlights

Response

Successful Response

video_idstring required
messagestring required
statusstring required