Welcome, Developer

Offtrack API

A powerful API for managing DJ song libraries and creating seamless transitions.

Getting Started

  1. Obtain your API key from the My Account tab
  2. Upload songs using the /song endpoint
  3. Wait for analysis to complete (check status with /songs)
  4. Create mixes with the /mix endpoint

Features

  • 🎵 Song Upload: Upload audio files
  • 📊 Audio Analysis: Automatic song analysis
  • 🎧 DJ Mix Creation: Generate DJ mixes with customizable transitions

Authentication

All endpoints (except / and /health) require an API key passed in the X-API-Key header.

API Endpoints

PUT /song

Upload Song

Upload audio files to your song library for analysis and mixing.

curl -X PUT http://offtrack-api-alb-1905413112.us-east-1.elb.amazonaws.com/song \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -F "file=@/path/to/your/song.mp3"

GET /songs

List Songs

Retrieve all songs in your library with their analysis status and metadata.

curl -X GET http://offtrack-api-alb-1905413112.us-east-1.elb.amazonaws.com/songs \
  -H "x-api-key: YOUR_API_KEY_HERE"

GET /mix

Create DJ Mix

Generate a seamless DJ mix with customizable transitions between songs. Specify song IDs as comma-separated values in the song_ids query parameter.

curl -X GET "http://offtrack-api-alb-1905413112.us-east-1.elb.amazonaws.com/mix?song_ids=song_1,song_2,song_3" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  --output /tmp/mix.mp3