Waveforms
Get raw waveform peaks for any audio asset in the Slipstream catalog — tracks, sound effects, or individual stems. The endpoint returns a JSON peaks array that you render in your own canvas/SVG. No images, no SVGs, no pre-rendered art.
Endpoints
| Method | Path | Use when |
|---|---|---|
GET | /api/v4/music/waveforms/{audio_type}/{audio_id}/ | You want the peaks data for a track, sound effect, or stem |
Authentication
Waveforms are public — no token required. Send one if you have it; it doesn’t change the response:
Authorization: Bearer <PARTNER_API_KEY>Lazy generation
Waveforms are generated on demand and cached. The first request for a freshly added asset may return 202 Accepted with a status message while a background worker generates the peaks. Retry the same call after a few seconds — once the worker finishes you’ll get 200 OK with the data.
Cache the response on your side. Waveforms don’t change for an asset’s lifetime, so a one-time fetch per asset is enough. Don’t refetch on every render.