Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Imentiv AI AI Insights API API

The AI Insights API provides conversational AI-powered analysis of emotional data from your media content.**Features:**- Ask natural language questions about detected emotions, patterns, and trends- Receive AI-generated insights with real-time streaming (SSE)- Conversation continuity across multiple messages- Works with all media types: video, audio, image, and text**Endpoints:**- `POST /v2/{media_type}/{media_id}/ai-insights` - Send a message and receive AI response (streaming recommended)- `GET /v2/{media_type}/{media_id}/ai-insights` - Retrieve conversation history**Use Cases:** Ideal for gaining deeper insights into emotional patterns, generating summaries, comparing emotional states, and understanding sentiment trends in your media content.

Imentiv AI AI Insights API API is one of 6 APIs that Imentiv AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AI Insights API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 1 path, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against the base URL https://api.imentiv.ai.

2 operations 1 paths 4 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.imentiv.ai
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Imentiv AI AI Insights API API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (APIKeyHeader).

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

AI Insights API 2

The AI Insights API provides conversational AI-powered analysis of emotional data from your media content. Features: - Ask natural language questions about detected emotions, patt…

POST
/v2/{media_type}/{media_id}/ai-insights
Send message to AI Insights
chat_ai_insights_v2__media_type___media_id__ai_insights_post 3 params body → 200400401404422500
GET
/v2/{media_type}/{media_id}/ai-insights
Get AI Insights conversation history
get_ai_insights_history_v2__media_type___media_id__ai_insights_get 2 params → 200401404422

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are AIInsightsChatResponse (5 properties), AIInsightsChatMessage (4 properties), AIInsightsHistoryResponse (2 properties), AIInsightsChatRequest (1 property). Each schema is shown below with its type and property counts.

AIInsightsChatMessage
object
Individual message in conversation history. Attributes: role (str): Message role - "user" or "aiassistant". text (str): Message text content. messageid (int):…
4 properties 3 required
AIInsightsHistoryResponse
object
Response model for retrieving AI Insights conversation history. Attributes: conversationid (str): The conversation session ID. messages (List[AIInsightsChatMes…
2 properties 2 required
AIInsightsChatRequest
object
Request model for sending a message to AI Insights (REST API). The system automatically manages conversation continuity - one conversation per user per media i…
1 property 1 required
AIInsightsChatResponse
object
Response model for AI Insights chat (non-streaming mode with ?stream=false). Attributes: conversationid (str): Unique identifier for this conversation session.…
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imentiv-ai-ai-insights-api-api-openapi.yml Raw ↑

Other APIs Imentiv AI publishes across the network.

Imentiv AI Audio Emotion API API
Imentiv AI Image Emotion API API
Imentiv AI Report API API
Imentiv AI Text Emotion API API
Imentiv AI Video Emotion API API