Video Emotion API
The Video Emotion Analysis API by Imentiv analyzes the emotional states of individuals in a video. It performs multi-modal emotion detection using facial expressions, audio, and text transcript, and has the following features:
- Overall emotion summary
- Frame-by-frame emotion data
- Per-face emotional analysis
- Valence-arousal-intensity data
- Audio and transcript emotion data
- Personality analysis
- Video Highlights
- Optional psychological insights
Upload Video
Analyze emotions and facial expressions from video content.
List Videos
Retrieves a paginated list of uploaded video files associated with the authenticated user.
Get Video Emotion Insights
Get a single video details by ID
Reprocess Video
Reprocess an already uploaded and completed video file.
Delete Video
Permanently deletes a video and its emotional insights. This action is irreversible.
Get Video Multimodal Insights
Get complete multimodal analytics for a video including:
Get Average Emotions
Calculate and retrieve average emotion scores for a video with optional face filtering.
Get Annotated Video
Get annotated video with emotion labels and bounding boxes overlaid on each frame.
Get Valence Arousal
Get emotion intensities of a video based on video_id
Get Multiple Frame
Per-frame face detections.
Get Single Frame
One stored frame. Per-face emotion scores are on `faces[].emotions`.
Retrieve Domination Emotion For A Specific Frame
This API endpoint is designed to fetch and return the dominant emotion of frames within a video based on its video_id.
Retrieve Emotion Intensity
Retrieve Emotion Intensity for a Specific Frame
Update Emotion Per Frame
Update the emotion of a specific face in a frame
Edit Face Note
Update the note associated with a detected face in a frame.
Update Multiple Faces
Update Face ID in multiple frames of a video
Merge Face
Merge multiple face detections into a single face to remove duplicates from a video.
Delete Faces
Delete specified faces from a video while ensuring at least one face remains.
Update Faces Names
Updates the names of multiple faces in a video.
Process Highlight
Trigger automatic highlight video generation using emotion-based analysis.
Fetch Highlight Video
API endpoint for highlight generation of a video.
Update Highlight Video
Generate custom highlight video using user-defined time segments.
Download Highlight Video
Download the highlight video.
Edit Title Or Description By Id
Edit the title or description of a video based on the provided video ID.
Generate Video Emotion Analysis Report
Initiates the generation of an analysis report for the specified video.
Download Video Emotion Analysis Report
Download a videos processed analysis details based on the provided video ID.
Add Face
Create a placeholder face on a video file. The new face has no detection
Trim Video Endpoint
Crop an uploaded video by trimming time off the beginning and/or the end.
Delete Video V2
Permanently delete a video, its stored media and its analyses. This action is irreversible.
Get Video Details
Retrieve all details for a specific video directly from the database.
Get Video Face Analysis
Per-frame gaze, eye, blink, liveness, and lip signals — no frame images.
Get Video Face Image Url Route
Get a short-lived URL for a face's image.
Get Personality Analysis
Retrieve OCEAN personality analysis results for a specific face in a video.
Get Video Moments Api
Notable moments in a processed video, per face or speaker.
Request Video Moments Api
Request Moments for a processed video. Credits are charged once per video.
Resolve Video Moments Api
Follow moment ids from an earlier computation to the latest stored moments.
Put Video Non Human Spans
Replace known non-human audio, such as a voice assistant or music.
Trigger Personality Analysis
Trigger personality analysis for a specific face in a video.
Get Video Playback Url Route
Get a short-lived URL for playing back a video.
Import Provider Tags
Import importer-sourced tags (e.g. provider ``vpm.*``, cohort
Trigger Speaker Face Match
Trigger automatic AI-driven speaker-to-face matching for a video.
Update Speaker Face Match
Manually match detected faces to identified speakers with bidirectional name synchronization.
Get Speaker Face Match Suggestions Route
Return the stored speaker-face match suggestions for a video.
Trigger Speaker Face Match Suggestions
Trigger automatic speaker-to-face matching in **suggestions** mode.
Add Video Tag
Add or replace a user-source tag on a video.
Remove Video Tag
Delete a user-source tag from a video.
Get Video Transcript
Read a video's own transcript, or the transcript attached to it.
Put Video Provider Transcript
Attach a transcript produced elsewhere (for example by a meeting provider) to a video.