Passer au contenu

Documentation du développeur UlazAI

Génération audio API

API du Studio de musique

Suno API

Créez des chansons et continuez à les retravailler via la même API que celle du Studio de musique.

Ouvrir le Studio de musique

Consultez le catalogue des opérations pour connaître les modèles actuels, les champs requis et les prix en crédits. Envoyez un identifiant de requête unique pour qu'une nouvelle tentative ne puisse pas être facturée deux fois.

GET  /api/v1/music/studio/catalog/
POST /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/<id>/
POST /api/v1/music/studio/upload/

Votre bibliothèque inclut toutes les prises renvoyées. Une modification crée un nouveau résultat et conserve l'original.

Génération audio API

Générez de la musique, des voix off et des effets sonores à l'aide des crédits UlazAI. Les résultats sont fournis de manière asynchrone : soumettez une tâche, puis interrogez le point de terminaison d'état jusqu'à ce qu'elle soit terminée.

Authentification : utiliser Authorization: Bearer <ulazai_api_key> ou Authorization: Token <token>.

🎵 Musique

POSTER /api/v1/music/generate/ Authentification requise

Générez une piste musicale à partir d'un prompt.

Corps de la demande

{
  "prompt": "Upbeat synthwave track with neon retro vibes",
  "model": "V5",               // Options: "V5", "V4_5PLUS" (default: V4_5PLUS)
  "duration": 30,              // Optional (seconds)
  "instrumental": true,        // Optional (default: true)
  "title": "Neon Nights",      // Optional
  "style": "synthwave, 120bpm" // Optional
}

Réponse (201 créés)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "processing",
    "status_url": "/api/v1/music/status/uuid-here/",
    "credits_used": 12,
    "credits_remaining": 88
  }
}

Coût du crédit : 12 crédits par demande.

OBTENIR /api/v1/music/status/<music_id>/ Authentification requise

Sondage pour l'achèvement du travail.

Réponse (200 OK, complété)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "completed",
    "audio_url": "https://media.ulazai.com/...",
    "credits_used": 12
  }
}

🎙️ Voix off

POSTER /api/v1/voiceover/generate/ Authentification requise

Convertissez le texte en voix off.

Corps de la demande (TTS)

{
  "model": "tts_turbo_25",     // Options: "tts_turbo_25", "tts_v3"
  "text": "Welcome to UlazAI Studio. Let's create something amazing.",
  "voice": "Rachel",          // Optional
  "speed": 1.0                // Optional (0.7 - 1.2)
}

Corps de la requête (dialogue)

{
  "model": "dialogue_v3",
  "dialogue": [
    {"voice": "Rachel", "text": "We need a new hook for this ad."},
    {"voice": "Roger",  "text": "Let's make it shorter and punchier."}
  ]
}

Coût du crédit : basé sur le nombre de personnages. Turbo2.5 : 12 crédits pour 1 000 caractères. V3/Dialogues : 14 crédits pour 1 000 caractères.

OBTENIR /api/v1/voiceover/status/<voiceover_id>/ Authentification requise

Sondez pour terminer et récupérez l’URL audio.

🔊 Effets sonores

POSTER /api/v1/sound-effects/generate/ Authentification requise

Générez un effet sonore à partir d'un prompt.

Corps de la demande

{
  "text": "A futuristic UI beep with a short tail",
  "loop": false,
  "duration_seconds": 2.5
}

Coût du crédit : 0,24 crédits/s (arrondis à l'unité supérieure), minimum 1 crédit.

OBTENIR /api/v1/sound-effects/status/<sfx_id>/ Authentification requise

Sondez pour terminer et récupérez l’URL audio.