API 문서
Nebulux API
간단한 REST API로 마스터링을 자동화하세요.
빠른 시작
1API 키 발급
설정 페이지 에서 API 키를 생성하세요.
2마스터링 요청
curl -X POST "https://api.nebulux.io/v1/mastering" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "[email protected]" \
-F "preset=balanced" \
-F "output_format=mp3"3결과 확인
작업이 완료되면 download_url에서 마스터링된 파일을 다운로드할 수 있습니다.
인증
모든 API 요청에 Authorization 헤더가 필요합니다.
Authorization: Bearer YOUR_API_KEY엔드포인트
POST/mastering
새 마스터링 작업 생성
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
file | File | 필수 | 오디오 파일 (MP3, WAV, FLAC, AAC, OGG, M4A) |
preset | string | 선택 | bright | smooth | balanced (기본값: balanced) |
output_format | string | 선택 | mp3 | wav | flac (기본값: mp3) |
응답 예시
{
"job_id": "mst_abc123",
"status": "processing",
"created_at": "2024-01-15T10:30:00Z"
}GET/mastering/:job_id
마스터링 작업 상태 조회
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
job_id | string | 필수 | 작업 ID (URL 파라미터) |
응답 예시
{
"job_id": "mst_abc123",
"status": "completed",
"progress": 100,
"download_url": "https://...",
"created_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T10:31:00Z"
}GET/credits
크레딧 잔액 조회
응답 예시
{
"credits": 15,
"used_this_month": 5
}GET/mastering/history
마스터링 작업 히스토리
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
limit | number | 선택 | 조회 개수 (기본값: 20, 최대: 100) |
offset | number | 선택 | 시작 위치 (기본값: 0) |
응답 예시
{
"jobs": [
{
"job_id": "mst_abc123",
"original_filename": "track.wav",
"preset": "balanced",
"status": "completed",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 42,
"limit": 20,
"offset": 0
}Rate Limits
- 마스터링 요청: 분당 10회
- 상태 조회: 분당 60회
- 엔터프라이즈 플랜: 제한 없음