Documentation API

Nebulux API

Automatisez le mastering avec une API REST simple.

Démarrage Rapide

1Obtenir une Clé API

Page des paramètres pour générer une clé API.

2Faire une Requête
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"
3Obtenir les Résultats

Une fois terminé, téléchargez votre fichier masterisé depuis download_url.

Authentification

Toutes les requêtes API nécessitent l'en-tête Authorization.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST
/mastering

Créer un nouveau travail de mastering

Paramètres

NomTypeRequisDescription
fileFile
Requis
Fichier audio (MP3, WAV, FLAC, AAC, OGG, M4A)
presetstringOptionnelbright | smooth | balanced (défaut: balanced)
output_formatstringOptionnelmp3 | wav | flac (défaut: mp3)

Exemple de Réponse

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

GET
/mastering/:job_id

Obtenir le statut du travail

Paramètres

NomTypeRequisDescription
job_idstring
Requis
ID du travail (paramètre URL)

Exemple de Réponse

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

Obtenir le solde de crédits

Exemple de Réponse

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

GET
/mastering/history

Historique des travaux de mastering

Paramètres

NomTypeRequisDescription
limitnumberOptionnelNombre de résultats (défaut: 20, max: 100)
offsetnumberOptionnelPosition de départ (défaut: 0)

Exemple de Réponse

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

Limites de Taux

  • Requêtes de mastering: 10 par minute
  • Vérifications de statut: 60 par minute
  • Plan Enterprise: Illimité