Skip to main content
POST
Classify a song's music genre

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
audio
string
required

One song (public URL, uploaded-file URL, data URI, or raw base64). Max 20 MB and 7 minutes. MP3/WAV/OGG/M4A/FLAC.

Response

The classification.

clip
object

The excerpt the classifier heard.

confidence
number

Classifier confidence, 0-1.

credits_charged
integer
genre
string

Canonical genre, e.g. Electronic & Dance. One of the site's music genres.

genre_slug
string

URL-safe slug of the genre, e.g. electronic-and-dance.

id
string

Classification request id (audit reference).

mood
string

One short mood phrase.

tags
string[]

3-6 style/mood/instrument tags.