Documentación API

Nebulux API

Automatiza la masterización con una API REST simple.

Inicio Rápido

1Obtener Clave API

Página de configuración para generar una clave API.

2Hacer Solicitud
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"
3Obtener Resultados

Cuando termine, descarga tu archivo masterizado desde download_url.

Autenticación

Todas las solicitudes API requieren el encabezado Authorization.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST
/mastering

Crear nuevo trabajo de masterización

Parámetros

NombreTipoRequeridoDescripción
fileFile
Requerido
Archivo de audio (MP3, WAV, FLAC, AAC, OGG, M4A)
presetstringOpcionalbright | smooth | balanced (predeterminado: balanced)
output_formatstringOpcionalmp3 | wav | flac (predeterminado: mp3)

Respuesta de Ejemplo

{
  "job_id": "mst_abc123",
  "status": "processing",
  "created_at": "2024-01-15T10:30:00Z"
}

GET
/mastering/:job_id

Obtener estado del trabajo

Parámetros

NombreTipoRequeridoDescripción
job_idstring
Requerido
ID del trabajo (parámetro URL)

Respuesta de Ejemplo

{
  "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

Obtener saldo de créditos

Respuesta de Ejemplo

{
  "credits": 15,
  "used_this_month": 5
}

GET
/mastering/history

Historial de trabajos de masterización

Parámetros

NombreTipoRequeridoDescripción
limitnumberOpcionalCantidad de resultados (predeterminado: 20, máx: 100)
offsetnumberOpcionalPosición inicial (predeterminado: 0)

Respuesta de Ejemplo

{
  "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
}

Límites de Tasa

  • Solicitudes de masterización: 10 por minuto
  • Verificación de estado: 60 por minuto
  • Plan Enterprise: Sin límites