VYBE Library for developers

curl https://vybemusic.com/api/library/v1/me \
  -H "Authorization: Bearer $VYBE_KEY"

const VYBE = 'https://vybemusic.com/api/library/v1';
const vybe = (path, init = {}) => fetch(VYBE + path, {
  ...init,
  headers: { Authorization: 'Bearer ' + process.env.VYBE_KEY, 'Content-Type': 'application/json', ...init.headers },
}).then(async r => { const body = await r.json(); if (!r.ok) throw Object.assign(new Error(body.error.message), body.error); return body; });

const me = await vybe('/me');

{ "error": { "code": "invalid_request", "message": "bpm_min must be a number between 20 and 400" } }

curl -X POST https://vybemusic.com/api/library/v1/sessions \
  -H "Authorization: Bearer $VYBE_SECRET_KEY" -H "Content-Type: application/json" \
  -d '{"user":"user-42","hours":1}'

{ "token": "vybe_ct_...", "expires_at": "2026-10-21T12:00:00.000Z" }

{
  "name": "Your App",
  "slug": "your-app",
  "status": "active",
  "commercial": false,
  "rate_limit": { "per_minute": 600 },
  "terms_version": "2026-10-21",
  "key": { "prefix": "vybe_pk_Ab3x", "label": "production" }
}

{ "data": [ { "id": "hype", "name": "Party", "line": "Your living room is a club now. Act accordingly." }, ... ] }

curl "https://vybemusic.com/api/library/v1/tracks?vybe=hype&bpm_min=120&bpm_max=128&camelot=8A&explicit=false&limit=20" \
  -H "Authorization: Bearer $VYBE_KEY"

const qs = new URLSearchParams({ vybe: 'hype', bpm_min: '120', bpm_max: '128', camelot: '8A', explicit: 'false', limit: '20' });
let page = await vybe('/tracks?' + qs);
const all = [...page.data];
while (page.next_cursor) {
  page = await vybe('/tracks?' + new URLSearchParams({ ...Object.fromEntries(qs), cursor: page.next_cursor }));
  all.push(...page.data);
}

{
  "data": [
    {
      "id": "6c1f2a4e-8d3b-4f7a-9b21-0e5d7c9a1f30",
      "slug": "song-title",
      "title": "Song Title",
      "artist": { "name": "Artist Name", "slug": "artist-name", "avatar": "https://vybemusic.com/m/pub/a/.../image/avatar.webp", "verified": true, "url": "https://vybemusic.com/app/#/artist/artist-name" },
      "release": { "title": "Release Title", "kind": "ep" },
      "duration": 201.4,
      "bpm": 124,
      "key": "A minor",
      "camelot": "8A",
      "energy": 0.82,
      "loudness": -8.6,
      "vybes": ["hype", "fuel"],
      "genre": "House",
      "language": "en",
      "explicit": false,
      "isrc": "AEA0Q2600001",
      "cover": "https://vybemusic.com/m/pub/a/.../image/cover.webp",
      "waveform": [0.12, 0.34, 0.58, ...],
      "has_lyrics": true,
      "codecs": ["opus", "aac"],
      "released_at": "2026-10-01T00:00:00Z",
      "credits": [ { "name": "Artist Name", "role": "Main artist" }, { "name": "Producer Name", "role": "Producer" } ],
      "links": { "vybe": "https://vybemusic.com/app/#/track/song-title" },
      "attribution": "Music from VYBE: Song Title by Artist Name"
    }
  ],
  "next_cursor": "eyJvIjoyMH0"
}

curl https://vybemusic.com/api/library/v1/tracks/6c1f2a4e-8d3b-4f7a-9b21-0e5d7c9a1f30 \
  -H "Authorization: Bearer $VYBE_KEY"

const track = await vybe('/tracks/' + id);

{
  ...,
  "lyrics": {
    "plain": "First line\nSecond line",
    "synced": [ { "t": 12.4, "line": "First line", "section": "Verse 1" }, { "t": 15.9, "line": "Second line", "section": "Verse 1" } ],
    "sections": [ { "type": "verse", "label": "Verse 1", "performer": "Nia", "start": 12.4, "end": 31.0, "lines": ["First line", "Second line"], "inferred": false } ],
    "structure": [ "Intro", "Verse 1", "Pre Hook", "Hook", "Drop", "Verse 2", "Pre Hook", "Hook", "Drop", "Bridge", "Hook", "Outro" ]
  },
  "analysis": {
    "beats": { "first": 0.42, "period": 0.48387, "downbeat": 0.42 },
    "sections": [ { "start": 0, "end": 30.9, "label": "intro" }, ... ],
    "drop": 61.8,
    "danceability": 0.78,
    "valence": 0.64,
    "energy_curve": [0.21, 0.25, ...]
  }
}

curl -X POST https://vybemusic.com/api/library/v1/tracks/6c1f2a4e-8d3b-4f7a-9b21-0e5d7c9a1f30/stream \
  -H "Authorization: Bearer $VYBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format":"audio","user":"u_83f1c2","country":"AE"}'

const media = await vybe('/tracks/' + id + '/stream', {
  method: 'POST',
  body: JSON.stringify({ format: 'audio', user: 'u_83f1c2', country: 'AE' }),
});
audioElement.src = media.stream_urls.aac || media.url;   // in the browser or app

{
  "format": "audio",
  "url": "https://vybemusic.com/m/4f9c...e21a",
  "meta_url": "https://vybemusic.com/m/4f9c...e21a?meta=1",
  "codecs": ["opus", "aac"],
  "stream_urls": { "opus": "https://vybemusic.com/m/4f9c...e21a?c=opus", "aac": "https://vybemusic.com/m/4f9c...e21a?c=aac" },
  "expires_at": "2026-10-21T18:00:00.000Z",
  "attribution": "Music from VYBE: Song Title by Artist Name"
}

curl -X POST https://vybemusic.com/api/library/v1/usage \
  -H "Authorization: Bearer $VYBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"events":[{"track_id":"6c1f2a4e-8d3b-4f7a-9b21-0e5d7c9a1f30","event":"stream","seconds":187,"user":"u_83f1c2","country":"AE"}]}'

// collect events as they happen, then send them in batches
await vybe('/usage', { method: 'POST', body: JSON.stringify({ events: queue.splice(0, 500) }) });

{ "accepted": 1, "rejected": 0 }

curl https://vybemusic.com/api/library/v1/artists/artist-name \
  -H "Authorization: Bearer $VYBE_KEY"

const artist = await vybe('/artists/artist-name');

{
  "name": "Artist Name",
  "slug": "artist-name",
  "avatar": "https://vybemusic.com/m/pub/a/.../image/avatar.webp",
  "cover": "https://vybemusic.com/m/pub/a/.../image/cover.webp",
  "city": "Dubai",
  "verified": true,
  "genres": ["House", "Afro House"],
  "url": "https://vybemusic.com/app/#/artist/artist-name",
  "tracks": [ { ...track } ]
}

<script src="https://vybemusic.com/sdk/vybe.js"></script>
<script>
  // media.url from POST /v1/tracks/:id/stream with {"format":"vybe"}
  const song = await Vybe.open(media.url);              // reads only the index and META (Range requests)
  console.log(song.meta.title, song.meta.bpm);
  const audio = await song.audio({ prefer: ['opus', 'aac', 'mp3'] });   // best stream this device can play
  player.src = URL.createObjectURL(audio.blob);
  const peaks = await song.peaks();                      // Uint8Array waveform
  const lyrics = song.lyrics();                          // { plain, synced: [{ t, line }] } or null
</script>

const Vybe = require('./vybe.js');   // or: import Vybe from './vybe.js'

const buf = await fetch(media.url).then(r => r.arrayBuffer());
const file = Vybe.parse(buf);        // the whole file in memory
file.meta;                           // META JSON
file.verify();                       // true when every chunk matches its CRC32
file.audio({ prefer: ['aac'] });     // { blob, mime, codec, type, bytes }
file.audio({ preview: true });       // the preview clip instead of the full song
file.cover();                        // Blob of the artwork
file.get('PEAK');                    // raw bytes of any chunk