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: Billed on success; the amount is recorded after the run and is not quoted on this request. Each video is billed at least 10 credits. A 402 is returned before processing starts when admission is refused.

Moments: Set moments to run Moments on this video as part of the same request. It is billed with the analysis, and a single 402 covers both: when your balance cannot cover them together, nothing is charged and the video is not queued. If the video's first analysis fails, Moments is cancelled and you are not billed for it; once the video has been reprocessed, a later failure does not cancel it. Leave it off to request Moments later.

Request​

Responses​

Successful Response