> ## 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.

# Instructions d'intégration de l'API de clonage vocal Suno

> Suno Music Generation 集成指南 - XHuoAPI

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

```bash theme={null}
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 :

```json theme={null}
{
  "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](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) 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`.

```bash theme={null}
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 :

```json theme={null}
{
  "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.