Quickstart

Get your first mastered track in under 5 minutes.

1. Get an API Key

Sign up for a WhitePrint account and navigate to Settings → API Keys to generate your key. Include it as the X-Api-Key header in all requests.

2. Prepare Your Audio

Upload your audio file to any cloud storage (Google Drive, Dropbox, OneDrive, S3, or GCS) and get a direct download URL. The URL must return the raw audio file.

3. Send Your First Request

API Key

Audio URL

curl -X POST https://concertmaster.aimastering.tech/api/v1/jobs/master \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://your-storage.com/track.wav",
    "route": "full",
    "target_lufs": -14.0,
    "target_true_peak": -1.0
  }' \
  -o mastered.wav

4. Handle the Response

The response depends on the route you chose:

full / dsp_only→ audio/wav

Binary WAV file. Check X-Analysis and X-Deliberation headers for metadata.

analyze_only→ application/json

JSON with full BS.1770-4 metrics.

deliberation_only→ application/json

JSON with analysis + AI mastering parameters.

5. Response Headers

All routes return useful metadata in response headers:

X-Route: full

X-Elapsed-Ms: 12345

X-Analysis: {...}

X-Deliberation: {...}

X-Metrics: {...}