Guides Imọlẹ Parcours84 / 88
Modèle · Audio

ElevenLabs Music v2

Génération de musique pour chansons, instrumentaux, fonds sonores et jingles.

Identifiant du modèlemusic_v2
Route API POST /audio/music
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Music v2 transforme un brief musical en morceau complet. Structure, instrumentation, énergie et usage doivent être explicites.

Cette page rassemble la description du modèle, les réglages exposés par Imọlẹ et les informations nécessaires pour l’appeler avec l’API.

Capacités

Résultats et opérations pris en charge

  • Musique de fond, chansons, intros, boucles, publicités, jeux et concepts de film.
Demande

Décrire clairement le résultat attendu

Construisez la demande dans cet ordre. Chaque étape précise une information que le modèle peut utiliser directement.

  1. 01

    Usage

    Indiquez où la musique sera utilisée et ce à quoi elle doit laisser de la place.

  2. 02

    Genre et époque

    Choisissez un genre principal, une influence facultative et une époque de production.

  3. 03

    Ambiance et énergie

    Décrivez l’émotion et l’évolution de l’énergie.

  4. 04

    Tempo et instruments

    Donnez une plage de BPM ou un rythme, les instruments principaux et sons exclus.

  5. 05

    Structure

    Décrivez intro, développement, pic, pause et fin ou boucle.

Exemple 1

Fond de lancement produit

Fond instrumental de 45 secondes pour une vidéo de lancement IA. Afro-électronique moderne avec guitare highlife subtile, 108 BPM, optimiste et précise plutôt que festive, pulsation douce de marimba, basse électronique propre, percussions retenues. 0–8 s intro minimale, 8–28 s montée progressive, 28–38 s pic assuré, 7 dernières secondes avec résolution propre pour un logo. Laisser de la place à la narration, sans voix, sans impacts de bande-annonce.

Le brief définit usage, hiérarchie de genres, tempo, instruments, structure et exclusions.

Réglages

Contrôles disponibles dans Imọlẹ

Durée

Adaptez la durée au montage et décrivez la courbe d’énergie dans ce temps.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/audio/music
URL de basehttps://api.imole.app/v1
Coût API40 cauris
AuthorizationBearer $IMOLE_API_KEY
Content-TypeUtilisez application/json pour les requêtes JSON.

Chargez IMOLE_API_KEY depuis une variable d’environnement côté serveur. N’insérez jamais la clé dans le code envoyé au navigateur, une application mobile, un dépôt Git ou un fichier partagé.

Corps de requête

Paramètres acceptés

ParamètreDescriptionValeurs
modelRequis

Utilisez music_v2.

—
promptRequis

Brief musical : genre, ambiance, tempo, instruments et usage.

—
duration_seconds

Durée demandée en secondes.

—
music_length_ms

Durée demandée en millisecondes.

—
Code

Exemples d’intégration

Testez d’abord la requête cURL, puis reprenez le même identifiant de modèle dans votre application JavaScript ou Python.

Jingle court

curl -X POST "https://api.imole.app/v1/audio/music" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "music_v2",
  "prompt": "A calm five second startup jingle with marimba and soft bass",
  "duration_seconds": 5
}' \
  --output music-v2.mp3

Durée en millisecondes

curl -X POST "https://api.imole.app/v1/audio/music" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "music_v2",
  "prompt": "A bright product intro bed with light percussion and plucked synths",
  "music_length_ms": 8000
}' \
  --output music-v2-8s.mp3

Ambiance sonore plus longue

curl -X POST "https://api.imole.app/v1/audio/music" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "music_v2",
  "prompt": "A ten second ambient product bed with soft pads and gentle pulse",
  "duration_seconds": 10
}' \
  --output music-v2-10s.mp3
Production

Réponse, suivi et erreurs

1

La création renvoie un identifiant de tâche.

2

Interrogez son état jusqu’à `completed` ou `failed`.

3

Téléchargez le résultat seulement après la fin de la tâche.

400

Requête incorrecte : corrigez le champ indiqué avant de réessayer.

401

Clé absente, incorrecte ou révoquée.

402

Solde de cauris insuffisant.

429

Capacité temporairement indisponible : respectez `Retry-After` et utilisez un délai progressif.

5xx

Erreur temporaire : conservez l’identifiant de requête et évitez de relancer deux fois une opération facturable.

Cauris

Tarification et sources

Coût affiché40 cauris

Le coût exact dépend du modèle et, pour certains médias, de la durée, de la résolution ou de la qualité.

Documentation de référenceBonnes pratiques de rédaction musicale d’ElevenLabs