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 Authorization: Bearer wpk_... 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://aimastering.tech/api/master \
  -H "Authorization: Bearer wpk_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
  }'

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.

4. Polling for Results

Check the status of your mastering job by polling the jobs endpoint:

curl -X GET "https://aimastering.tech/api/jobs/<job_id>?object=<output_object>" \
  -H "Authorization: Bearer wpk_YOUR_API_KEY"

When the status becomes completed, you will receive a download URL and processing metrics.

5. Response Headers

All routes return useful metadata in response headers:

X-Route: full

X-Elapsed-Ms: 12345

X-Analysis: {...}

X-Deliberation: {...}

X-Metrics: {...}