API Docs
Nebulux API
Automate mastering with a simple REST API.
Quick Start
1Get API Key
Settings page to generate an API key.
2Make Request
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"3Get Results
When complete, download your mastered file from download_url.
Authentication
All API requests require the Authorization header.
Authorization: Bearer YOUR_API_KEYEndpoints
POST/mastering
Create new mastering job
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
file | File | Required | Audio file (MP3, WAV, FLAC, AAC, OGG, M4A) |
preset | string | Optional | bright | smooth | balanced (default: balanced) |
output_format | string | Optional | mp3 | wav | flac (default: mp3) |
Example Response
{
"job_id": "mst_abc123",
"status": "processing",
"created_at": "2024-01-15T10:30:00Z"
}GET/mastering/:job_id
Get mastering job status
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
job_id | string | Required | Job ID (URL parameter) |
Example Response
{
"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
Get credit balance
Example Response
{
"credits": 15,
"used_this_month": 5
}GET/mastering/history
Mastering job history
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | Optional | Number of results (default: 20, max: 100) |
offset | number | Optional | Starting position (default: 0) |
Example Response
{
"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
- Mastering requests: 10 per minute
- Status checks: 60 per minute
- Enterprise plan: Unlimited