Skip to main content
POST
Detect emotion in an audio file

Authorizations

X-API-Key
string
header
required

API key used for authentication and usage tracking.

Body

multipart/form-data
upload_file
file
required

Audio file to analyze. Supported formats: AAC, AIFF, FLAC, MP3, MP4, MOV, OGG, Opus, WAV, WebM. Maximum file size: 100MB. Empty files are rejected.

training_permitted
boolean
default:true

Whether this request's audio may be used to improve the models.

use_ensemble
boolean
default:false

When true, performs a more thorough analysis that may change the returned labels and increases latency.

Response

Emotion detection completed successfully

emotion
string
required

The emotion label for the whole file. Always present and non-null.

Example:

"Happy"

time_series
object[]
required

Consecutive fixed-length windows over the file, each with its own emotion label. Empty when the file is shorter than one window.