POST
/v1/audio-features/upload
Full analysis from uploaded audio
Upload raw audio for full analysis (BPM + key + mood + spectral). Returns 202 with a `job_id`; poll `GET /v1/jobs/{job_id}` until `status=complete`. Charges 10 credits on reserve, refunded on failure. Maximum upload size is tier-dependent (15 MB Starter / 50 MB Pro). Use `?format=spotify` to receive the result shape in Spotify-parity format once the job completes.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
format |
query | string | no | |
include_embedding |
query | boolean | no | (PRO only) Include 768-dimensional MAEST embedding in result. |
Request Body
Content type: audio/*
· required
Example request
cURL
curl https://api.brizm.dev/v1/audio-features/upload \
-H "Authorization: Bearer tl_live_xxx"