Documentation du développeur UlazAI
Génération audio API
API du Studio de musique
Créez des chansons et continuez à les retravailler via la même API que celle du 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
/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.
/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
/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.
/api/v1/voiceover/status/<voiceover_id>/
Authentification requise
Sondez pour terminer et récupérez l’URL audio.
🔊 Effets sonores
/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.
/api/v1/sound-effects/status/<sfx_id>/
Authentification requise
Sondez pour terminer et récupérez l’URL audio.