|API Docs

API Documentation

Masterify REST API를 사용하여 마스터링 워크플로우를 자동화하세요. 모든 요청에는 헤더가 필요합니다.

Base URLhttps://api.masterify.net

REST API · Webhook · Pro 이상

Quick Start

바로 시작할 때는 템플릿 허브부터 보세요

make.com, n8n용 스타터 JSON과 단계별 가이드를 함께 제공합니다. 코드 예제를 읽기 전에 import 가능한 플로우를 먼저 내려받아 바로 테스트할 수 있습니다.

템플릿 허브 열기 대표 템플릿 보기

포함된 템플릿

Google Drive 업로드 감지 → 마스터링 → Slack 전달
Airtable 큐 읽기 → 마스터링 → Row 업데이트
Form 업로드 수집 → 마스터링 → 클라이언트 이메일 발송

인증

모든 API 요청은 Bearer 토큰 인증이 필요합니다. 대시보드 설정 페이지에서 API 키를 생성하세요. 키 형식: + 32자리 hex.

curl -H "Authorization: Bearer aim_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

플랜별 API 제한

플랜	API 키	Rate Limit	Webhooks
free	1개	5회/분	1
starter	3개	30회/분	5
pro	5개	60회/분	10
studio	10개	120회/분	∞

POST/api/v1/master

마스터링 작업 생성

오디오 파일을 업로드하고 마스터링 작업을 생성합니다. 파일은 MP3/WAV/FLAC 형식, 최대 50MB, 10분 이하여야 합니다.

Request Bodymultipart/form-data

이름	타입	필수	설명
file	`File`	Yes	오디오 파일 (MP3, WAV, FLAC)
platforms	`string`	Yes	콤마 구분 플랫폼: spotify, apple_music, youtube, melon, soundcloud
genre	`string`	No	장르: kpop, edm, ballad, hiphop, pop, other (기본값: other)
ai_service	`string`	No	AI 서비스: suno, udio, elevenlabs, other (기본값: other)
tier	`string`	No	마스터링 티어: standard, premium (기본값: standard)
webhook_url	`string`	No	작업 완료 시 콜백 URL (per-job)
reference_file	`File`	No	레퍼런스 트랙 (톤 매칭용)

Response201

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

에러 응답

모든 에러는 동일한 형식으로 반환됩니다:

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

HTTP	코드	설명
400	FILE_TOO_LARGE	파일 크기가 50MB를 초과
400	UNSUPPORTED_FORMAT	MP3, WAV, FLAC만 지원
400	FILE_TOO_LONG	10분을 초과하는 파일
400	INVALID_PLATFORM	유효하지 않은 플랫폼
402	INSUFFICIENT_CREDITS	크레딧 부족
429	CONCURRENT_LIMIT	동시 처리 한도 초과
401	INVALID_API_KEY	유효하지 않은 API 키
429	RATE_LIMIT	요청 빈도 초과

Quick Start

3단계로 첫 마스터링을 시작하세요.

API 키 생성

대시보드 → 설정 → API 키 생성

aim_live_a1b2c3d4...

마스터링 요청

POST /api/v1/master 로 파일 업로드

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

결과 다운로드

status=done 이 되면 다운로드

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

질문이 있으신가요? 랜딩페이지 API 섹션에서 더 자세한 정보를 확인하세요.