Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

SUNO nous permet de créer des personnages vocaux personnalisés à partir de n’importe quel fichier audio, réalisant ainsi un clonage vocal pour la génération musicale. Contrairement à l’API Persona existante (qui utilise un audio_id généré par Suno), cette API accepte un audio_url accessible publiquement, c’est-à-dire votre propre enregistrement vocal. Ce document explique comment intégrer l’API de clonage vocal.

​
Première étape : créer un personnage vocal

Cette API possède trois paramètres d’entrée : audio_url (obligatoire), qui est une URL publique d’un fichier audio au format MP3 ou WAV contenant une voix claire d’une seule personne ; name et description (optionnels), qui correspondent au nom et à la description du personnage vocal. Exigences pour le fichier audio :
  • Format : MP3 ou WAV
  • Durée : au moins 10 secondes
  • Contenu : voix claire d’une seule personne, avec un minimum de bruit de fond ou de musique
curl -X POST 'https://api.xhuoapi.ai/v1/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "Exemple d'enregistrement vocal utilisateur"
}'
Le résultat est le suivant : 
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
On peut voir que le champ persona_id dans data correspond à l’ID du personnage vocal créé. Le champ is_public est toujours false car les personnages vocaux créés par téléchargement audio sont privés.

​
Deuxième étape : générer de la musique avec le personnage vocal

Une fois que vous disposez de l’ID du personnage vocal, vous pouvez utiliser la Suno Audios Generation API pour générer de la musique. Définissez action sur generate et persona_id sur l’ID du personnage vocal retourné précédemment. La chanson générée sera chantée avec la voix clonée.
Remarque : Le clonage vocal est uniquement compatible avec les modèles chirp-v4-5 et supérieurs (par exemple chirp-v4-5, chirp-v5, chirp-v5-5), et ne supporte pas chirp-v4. 
curl -X POST 'https://api.xhuoapi.ai/v1/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
Le résultat est le suivant : 
{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
On peut constater que la chanson générée est chantée avec la voix clonée. Le persona_id peut également être utilisé avec l’action cover pour reprendre des chansons existantes avec la voix clonée.