---
title: "Upload Audio"
method: POST
path: "/v2/audios"
tags: ["Audio Emotion API"]
---

# Upload Audio

`POST /v2/audios`

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.

## Response `200`

Successful Response

- AudioEmotionResponseV2 — V2 response model for audio emotion detection with URL source tracking. Supports: - YouTube URLs (audio extracted from video) - Cloud storage URLs (Dropbox, direct URLs, etc.) - Time parameters for all URL types - URL source tracking with media type detection Attributes: id (str): Unique ID of the audio. title (str): Title of the audio. status (str): Processing status (queue, processing, done, etc.). duration (int): Duration in seconds (trimmed duration if time params provided). media_source (str): Source type ("youtube", "dropbox", "public_url", "file_upload"). media_source_url (str): Full URL as provided by user. media_source_type (str): Type of source media ("video" or "audio"). user_id (str): ID of the user who uploaded the audio. created_at (Optional[str]): Timestamp when audio was created.
  - `id` string, required
  - `title` string, required
  - `status` string, required
  - `duration` integer, required
  - `media_source` string, required
  - `media_source_url` string, required
  - `media_source_type` string, required
  - `user_id` string, required
  - `created_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/4a61d1ac9025/schema)