Developer API — audio mastering in one request

Quick start — 3 steps

Example: curl

Mastering a single file: start the job, check the status, download the result.

curl -X POST https://magicmaster.pro/api/v2/master \
  -H "X-API-Key: mm_YOUR_KEY" \
  -F "file=@track.wav" \
  -F "style=edm" \
  -F "target_lufs=-9" \
  -F "out_format=wav"
# → {"job_id": "..."}; then:
curl https://magicmaster.pro/api/master/status/JOB_ID -H "X-API-Key: ..."
curl -o master.wav https://magicmaster.pro/api/master/result/JOB_ID -H "X-API-Key: ..."

Безопасные ретраи: передавайте заголовок Idempotency-Key (любая уникальная строка на запуск, например UUID) — повтор запроса с тем же ключом вернёт тот же job_id и не спишет второй токен, даже если первый ответ потерялся из-за обрыва сети.

curl -X POST https://magicmaster.pro/api/v2/master \
  -H "X-API-Key: mm_YOUR_KEY" \
  -H "Idempotency-Key: 4f7c2e10-9b1d-4e5a-8c3f-2a6d0e8b1c9d" \
  -F "file=@track.wav" -F "style=edm"

Example: Python

The same flow with requests: upload the file and poll the status until it is done.

import requests, time

API = "https://magicmaster.pro"
HEADERS = {"X-API-Key": "mm_YOUR_KEY"}

with open("track.wav", "rb") as f:
    r = requests.post(
        f"{API}/api/v2/master",
        headers=HEADERS,
        files={"file": f},
        data={"style": "edm", "target_lufs": -9, "out_format": "wav"},
    )
r.raise_for_status()
job_id = r.json()["job_id"]

while True:
    s = requests.get(f"{API}/api/master/status/{job_id}", headers=HEADERS).json()
    if s["status"] == "done":
        break
    time.sleep(3)

audio = requests.get(f"{API}/api/master/result/{job_id}", headers=HEADERS)
with open("master.wav", "wb") as out:
    out.write(audio.content)

print(s["after_lufs"], s["true_peak_db"])

Endpoints

Master parameters

• style — genre preset, 23 presets: edm, rock, hip-hop, pop and more.
• target_lufs — target integrated loudness, e.g. −14 for streaming or −9 for a club master.
• out_format — output format: wav, mp3, flac, opus or aac.
• intensity — genre compression density from 0.5 (gentler) to 1.5 (denser), default 1.0.
• album_mode — batch only: set to 1 to preserve the relative loudness of album tracks.
• PRO parameters (denoise, deesser and more) — see the interactive OpenAPI documentation at /docs.

What status returns

• after_lufs — integrated loudness of the result (LUFS).
• true_peak_db — true peak of the result (dBTP).
• codec_check — an honest loudness and peak check after encoding to the chosen codec.
• tonal_analysis — tonal balance across frequency bands.
• lufs_timeline — loudness graph over the course of the track.
• input_clipping — clipping detected in the source and De-clipper activity.
• album_lufs_offset — the track's loudness offset in album mode.
• intensity — the compression density that was applied.

Limits and fairness

• 1 token = 1 master. No API subscriptions — you only pay for processed tracks.
• Up to 10 active API keys per account; any key can be revoked at any time.
• Files are processed in memory and are not stored on the server after the result is delivered.
• The full interactive specification (OpenAPI / Swagger) is available at /docs.

FAQ