Skip to main content

Upload Video

POST 
/v2/videos

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:

  1. Submit your video and receive an immediate response with a video ID
  2. Video is queued for processing (typically completes within minutes)
  3. Optionally receive a webhook notification via callback_url when complete
  4. Retrieve results using the video ID

Supported Formats: MP4, AVI, MOV, WebM, MPEG

Credit Usage: Processing is billed at a base rate of 1 credit per second of analyzed video duration (Professional and Enterprise plans: 0.5 credits per second). This base rate is discounted when speech-analysis stages are disabled — turning off transcription, diarization, and/or text_emotion lowers the per-second rate (the discount is anchored to the audio-track share of the rate). A reduced processing_fps tier discounts the rate separately. Discounts are applied before the credit is computed on the floored duration (rounded to whole seconds).

Request​

Responses​

Successful Response