Skip to main content
Version: 5.7.2

Welcome to Imentiv AI

Imentiv AI is an advanced Emotion AI platform that leverages deep learning to analyze human emotions across multiple media formats, including video, audio, images, and text. By interpreting facial expressions, vocal tones, and linguistic cues, it provides detailed emotional insights to support use cases such as content creation, marketing optimization, education, mental health assessments, and more.

Imentiv AI offers a suite of Emotion Recognition APIs that allow developers and businesses to seamlessly integrate advanced emotion analysis into their applications, enabling deeper insights into user engagement and emotional responses.

Required Headers​

All requests to the API must include the following headers:

headers = {
    "X-API-Key": get_secret("imentiv-api-key"),
    "Referer": "https://your-domain.com/"  # any non-empty value works
}

Referer can be your own domain or any non-empty string.

Key Features of Imentiv AI APIs​

1. Video Emotion API​

Functionality: Analyzes emotions in videos, whether uploaded directly or via YouTube links.

Insights Provided:

  • Frame-by-frame and actor-by-actor emotion analysis
  • Valence-arousal mapping to determine emotional intensity and positivity/negativity
  • Personality trait analysis using the Big Five (OCEAN) model
  • Emotion graphs and wheels to visualize emotional dynamics

Use Cases: Suitable for researchers analyzing bulk videos, advertising campaigns, webinars, online meetings, and other video-based content to optimize engagement and content strategy.

2. Image Emotion API​

Functionality: Detects and analyzes emotions in images.

Insights Provided:

  • Face detection and recognition
  • Emotion analysis for each detected face
  • Overall emotional tone of the image

Use Cases: Enhances image analysis for advertising, market research, psychological studies, and social media content.

3. Audio Emotion API​

Functionality: Analyzes emotions in audio recordings, either via direct uploads or by extracting audio from YouTube videos.

Insights Provided:

  • Differentiation between multiple speakers in a conversation
  • Emotion detection from vocal cues (e.g., happiness, sadness, anger, surprise)
  • Transcription and detection of up to 28 nuanced emotions (e.g., admiration, curiosity, disappointment, pride)
  • Audio summaries and detailed analytics

Use Cases: Provides emotional insights for podcasts, voice messages, call analysis, and other audio-based content.

4. Text Emotion API​

Functionality: Analyzes emotions in textual content.

Insights Provided:

  • Detection of 28 distinct emotions, including curiosity, disappointment, and excitement
  • Overall sentiment analysis and identification of dominant emotions at sentence level

Use Cases: Integrates into chatbots, social media platforms, and other text-based applications for sentiment and emotion analysis.

Authorization​

Learn how to obtain your API keys to access Imentiv AI APIs.

Generate API Key:​

  1. Sign up at imentiv.ai and log in to your account.
  2. Navigate to the 'My Profile' tab to obtain your API key.
  3. Use this API key to authorize your API calls.

Note: Keep your API key secure and do not share it publicly. Include it in your API requests using the Authorization header or as specified in the endpoint documentation.

Authentication​

Your Imentiv API key, from the My Profile tab of your dashboard. Send it verbatim — no prefix, no Bearer, no encoding.

Security Scheme Type:

apiKey

Header parameter name:

X-API-Key