Skip to main content

Insights API

The 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
  • Supports both real-time streaming (SSE) and standard JSON responses
  • Conversation continuity across multiple messages
  • Works with all media types: video, audio, image, and text

Endpoints:

  • POST /v2/{media_type}/{media_id}/insights - Send a message and receive AI response; supports streaming SSE or JSON (streaming recommended)
  • GET /v2/{media_type}/{media_id}/insights - Retrieve conversation history
  • DELETE /v2/{media_type}/{media_id}/insights - Clear 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.