Composer de la musique avec une réponse détaillée

POST

/v1/music/detailed

POST

/v1/music/detailed

curl -X POST https://api.elevenlabs.io/v1/music/detailed \
     -H "xi-api-key: xi-api-key" \
     -H "Content-Type: application/json" \
     -d '{
  "prompt": "A prompt for music generation",
  "music_length_ms": 10000
}'

{
  "audio": "[binary audio data]",
  "composition_plan": {
    "negative_global_styles": [
      "metal",
      "hip-hop",
      "country"
    ],
    "positive_global_styles": [
      "pop",
      "rock",
      "jazz"
    ],
    "sections": [
      {
        "duration_ms": 10000,
        "lines": [
          "Verse 1 lyrics"
        ],
        "negative_local_styles": [
          "metal",
          "hip-hop",
          "country"
        ],
        "positive_local_styles": [
          "pop",
          "rock",
          "jazz"
        ],
        "section_name": "Verse 1"
      }
    ]
  },
  "song_metadata": {
    "description": "Description de ma chanson",
    "genres": [
      "pop",
      "rock",
      "jazz"
    ],
    "is_explicit": false,
    "languages": [
      "en",
      "fr"
    ],
    "title": "My Song"
  }
}

Compose une chanson à partir d’un prompt ou d’un plan de composition.

Paramètres de requête

output_formatenumOptionnelPar défaut auto

Format de sortie de l’audio généré. Formaté sous la forme codec_sample_rate_bitrate. Utilisez “auto”, la valeur par défaut, pour laisser l’API choisir le format le plus adapté au modèle sélectionné : mp3_44100_128 pour les modèles v1 et mp3_48000_192 pour les modèles v2.

Requête

This endpoint expects an object.

promptstring or nullOptionnel<=4100 characters

Un prompt textuel simple à partir duquel générer un morceau. Ne peut pas être utilisé avec composition_plan.

composition_planobject or nullOptionnel

Plan de composition détaillé pour guider la génération de musique. Ne peut pas être utilisé conjointement avec prompt.

music_length_msinteger or nullOptionnel3000-600000

La durée de la chanson à générer, en millisecondes. Utilisée uniquement avec prompt. Elle doit être comprise entre 3 000 ms et 600 000 ms. Facultatif : si elle n’est pas fournie, le modèle choisira une durée en fonction du prompt.

model_idenumOptionnelPar défaut music_v1

Le modèle à utiliser pour la génération.

Valeurs autorisées:

seedinteger or nullOptionnel0-2147483647

Graine aléatoire pour initialiser le processus de génération musicale. Fournir la même graine avec les mêmes paramètres peut aider à obtenir des résultats plus cohérents, mais la reproductibilité exacte n’est pas garantie et les sorties peuvent changer lors des mises à jour du système. Ne peut pas être utilisé avec prompt.

force_instrumentalbooleanOptionnelPar défaut false

Si true, garantit que la chanson générée sera instrumentale. Si false, la chanson peut être instrumentale ou non selon le prompt. Peut uniquement être utilisé avec prompt.

finetune_idstring or nullOptionnel<=100 characters

L’ID du Finetune à utiliser pour la génération

respect_sections_durationsbooleanOptionnelPar défaut true

Contrôle la rigueur avec laquelle les durées des sections définies dans le composition_plan sont appliquées. Utilisé uniquement avec composition_plan et applicable seulement à music_v1 ; pour music_v2 et music_v2_5, les durées des sections sont toujours appliquées et ce paramètre est ignoré. Lorsque sa valeur est false pour music_v1, le modèle peut ajuster la durée de chaque section pour améliorer la qualité et la latence, tout en préservant la durée totale du morceau définie dans le plan.

store_for_inpaintingbooleanOptionnelPar défaut false

Indique s’il faut stocker le morceau généré pour l’inpainting.

with_timestampsbooleanOptionnelPar défaut false

Indique s’il faut renvoyer les horodatages des mots du morceau généré.

with_waveform_visualbooleanOptionnelPar défaut false

Indique s’il faut renvoyer la forme d’onde visuelle du morceau généré.

sign_with_c2pabooleanOptionnelPar défaut false

Indique s’il faut signer le morceau généré avec C2PA. S’applique uniquement aux fichiers MP3.

En-têtes de réponse

song-idstringOptionnel

Identifiant unique de la chanson générée

Réponse

Réponse multipart/mixed avec métadonnées JSON et fichier audio binaire

Erreurs

422

Unprocessable Entity Error