v1
latestOpenAPI 3.1.02026-07-1381127211.1 KBVideo Emotion API
Upload Video
Analyze emotions and facial expressions from video content.
Submit a video from multiple sources and receive detailed emotion analysis of all detected faces throughout the video timeline.
Input Sources:
- YouTube: Provide any YouTube video URL
- Cloud Storage: Dropbox, Google Drive, or other cloud service links
- Social Media: Instagram, Facebook, Twitter (X) videos
- Direct URL: Any publicly accessible video link
- File Upload: Upload video files directly from your device
Analyze Specific Segments: Focus on specific portions using start_millis and end_millis parameters. This helps target key moments and optimize credit usage.
How It Works:
- Submit your video and receive an immediate response with a video ID
- Video is queued for processing (typically completes within minutes)
- Optionally receive a webhook notification via callback_url when complete
- Retrieve results using the video ID
Supported Formats: MP4, AVI, MOV, WebM, MPEG
Credit Usage: Processing is billed at 1 credit per second of analyzed video duration. Professional and Enterprise plans: 0.5 credits per second.
post/v2/videos
Response
Successful Response