Skip to main content
POST
Detect music and speech 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 analyse. Must be non-empty. Supported formats: .3g2, .3ga, .3gp, .3gpp, .8svx, .aa3, .aac, .ac3, .act, .adts, .aif, .aifc, .aiff, .alac, .amb, .amr, .ape, .asf, .at3, .au, .avi, .avr, .awb, .bwf, .c2, .caf, .dss, .dts, .dtshd, .eac3, .ec3, .f4a, .f4b, .flac, .flv, .gsm, .iff, .m2a, .m2ts, .m4a, .m4b, .m4r, .m4v, .mka, .mkv, .mlp, .mmf, .mov, .mp+, .mp1, .mp2, .mp3, .mp4, .mpa, .mpc, .mpeg, .mpg, .mpga, .mpp, .mts, .mxf, .nist, .oga, .ogg, .ogx, .oma, .omg, .opus, .paf, .pvf, .qcp, .ra, .rf64, .rka, .rm, .rmvb, .sf, .shn, .snd, .sph, .spx, .svx, .tak, .thd, .ts, .tta, .vob, .voc, .vqf, .w64, .wav, .wave, .weba, .webm, .wma, .wmv, .wv. Maximum file size: 100 MB.

Response

Detection completed successfully.

filename
string
required

Name of the submitted audio file. Empty string if no filename was provided in the upload.

Example:

"my_audio.wav"

duration_s
number<double>
required

Total duration of the analysed audio in seconds.

Required range: x >= 0
Example:

5.76

primary_label
enum<string>
required

Overall classification of the clip:

  • music - music covers at least as much of the clip as speech, and more than zero.
  • speech - speech covers more of the clip than music, and more than zero.
  • neither - neither music nor speech reached the dominant threshold for any portion of the clip.
  • unknown - no frames could be produced from the audio.
Available options:
music,
speech,
neither,
unknown
Example:

"speech"

music_pct
number<double>
required

Percentage of the clip classified as containing music.

Required range: 0 <= x <= 100
Example:

0

speech_pct
number<double>
required

Percentage of the clip classified as containing speech.

Required range: 0 <= x <= 100
Example:

86.7

latency_ms
number<double>
required

End-to-end inference time in milliseconds.

Required range: x >= 0
Example:

1243.5

frames
object[]
required

Ordered list of per-frame classification results covering the full duration of the clip.