v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Audio Emotion API

Upload Audio

Analyze emotions and speech patterns from audio content.

Submit audio from multiple sources and receive detailed emotion analysis, speaker identification, and transcription with emotional insights.

Input Sources:

  • YouTube: Provide any YouTube video URL (audio will be extracted)
  • Instagram: Instagram Reels and video posts (public content)
  • Twitter/X: Twitter video posts and media content
  • Facebook: Facebook video posts (public content)
  • Cloud Storage: Dropbox, Google Drive, or other cloud service links
  • Direct URL: Any publicly accessible audio or video link
  • File Upload: Upload audio files directly from your device

Audio Extraction: Video files are supported for URLs only (YouTube, Instagram, Twitter, Facebook, Dropbox, direct links) - the audio track will be automatically extracted and analyzed. For file uploads, use audio formats only (MP3, WAV, AAC, M4A).

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 audio and receive an immediate response with an audio ID
  2. Audio is queued for processing (typically completes within minutes)
  3. Optionally receive a webhook notification via callback_url when complete
  4. Retrieve results using the audio ID

Supported Formats:

  • File Upload: MP3, WAV, AAC, M4A
  • Media URLs: MP3, WAV, AAC, M4A, MP4, AVI, MOV (audio extracted from video URLs)

Credit Usage: Processing is billed at 0.5 credits per second of analyzed audio duration. Professional and Enterprise plans: 0.25 credits per second.

Extra Parameters:

  • speaker_diarization (bool): Enable or disable speaker diarization for identifying different speakers in the audio. Default is True.
  • text_emotion_analysis (bool): Enable or disable transcript emotion analysis for the transcribed text. Default is True.
  • language (str, optional): Language code for the audio (e.g., 'en'). If not provided, language will be auto-detected.
post/v2/audios

Response

Successful Response

idstring required
titlestring required
statusstring required
durationinteger required
media_sourcestring required
media_source_urlstring required
media_source_typestring required
user_idstring required
created_atstring nullable