|API Docs

API Documentation

Automate your mastering workflow with the Masterify REST API. All requests require the header.

Base URLhttps://api.masterify.net

REST API · Webhook · Pro or higher

Quick Start

Start with the Template Hub

We provide starter JSONs and step-by-step guides for make.com and custom webhook workflows. Download a starter flow before reading code examples.

Open Template Hub View Featured Template

Included Templates

Google Drive upload detect → Mastering → Slack delivery
Airtable queue read → Mastering → Row update
Form upload collect → Mastering → Client email

Authentication

All API requests require Bearer token authentication. API keys can be created from dashboard settings on Pro and higher plans. Key format: + 32-char hex.

curl -H "Authorization: Bearer aim_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

API Limits by Plan

Plan	API Keys	Rate Limit	Webhooks
free	0	0/min	0
starter	0	0/min	0
pro	5	30/min	3
studio	20	100/min	10

POST/api/v1/master

Create Mastering Job

Upload an audio file and create a mastering job. Files must be MP3/WAV/FLAC format, max 50MB, 10 minutes or less.

Request Bodymultipart/form-data

Name	Type	Required	Description
file	`File`	Yes	Audio file (MP3, WAV, FLAC)
platforms	`string`	Yes	Comma-separated platforms: spotify, apple_music, youtube, melon, soundcloud
genre	`string`	No	Genre: kpop, edm, ballad, hiphop, pop, other (default: other)
ai_service	`string`	No	AI service: suno, udio, elevenlabs, other (default: other)
tier	`string`	No	Mastering tier: standard, premium (default: standard)
webhook_url	`string`	No	Callback URL on job completion (per-job)
reference_file	`File`	No	Reference track (for tone matching)

Response201

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "platforms": ["spotify", "apple_music"],
  "credits_used": 1,
  "credits_remaining": 19
}

Error Responses

All errors are returned in the same format:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "크레딧이 부족합니다."
  }
}

HTTP	Code	Description
400	FILE_TOO_LARGE	File size exceeds 50MB
400	UNSUPPORTED_FORMAT	Only MP3, WAV, FLAC supported
400	FILE_TOO_LONG	File exceeds 10 minutes
400	INVALID_PLATFORM	Invalid platform
402	INSUFFICIENT_CREDITS	Insufficient credits
429	CONCURRENT_LIMIT	Concurrent processing limit exceeded
401	INVALID_API_KEY	Invalid API key
429	RATE_LIMIT	Rate limit exceeded

Quick Start

Start your first mastering in 3 steps.

Create API Key

Dashboard → Settings → Create API Key

aim_live_a1b2c3d4...

Request Mastering

Upload file via POST /api/v1/master

curl -X POST .../v1/master \
  -H "Authorization: Bearer ..." \
  -F "[email protected]" \
  -F "platforms=spotify"

Download Result

Download when status=done

GET /api/v1/jobs/{id}/download

Have questions? Landing page API section for more information.