v1
latestOpenAPI 3.1.02026-07-1381127211.1 KBUpload 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:
- Submit your audio and receive an immediate response with an audio ID
- Audio is queued for processing (typically completes within minutes)
- Optionally receive a webhook notification via callback_url when complete
- 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.
Response
Successful Response