> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno API de clonage de voix Documentation

> Suno Music Generation API guide - Ace Data Cloud

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

## Étape 1 : Créer un personnage vocal

Cette API a trois paramètres d'entrée : `audio_url` (obligatoire), qui est une URL d'un fichier audio au format MP3 ou WAV accessible publiquement, contenant une voix humaine claire d'une seule personne ; `name` et `description` (facultatifs), qui sont le nom et la description du personnage vocal.

> **Exigences pour le fichier audio**
>
> * Le format audio doit être `WAV` ou `MP3`
> * La durée audio doit être comprise entre `10 et 240 secondes`, il est recommandé d'utiliser un matériau vocal clair d'une seule personne de `30 à 60 secondes`
> * L'audio doit contenir **une voix humaine claire et identifiable d'une seule personne parlant ou chantant**
> * Veuillez éviter **le bruit de fond, les accompagnements, les échos, la réverbération** ; les chansons complètes avec accompagnement ne peuvent généralement pas passer la vérification de la voix
> * Ne pas inclure **plusieurs locuteurs** ou **plusieurs voix**
> * Les matériaux avec un volume trop bas, une voix peu claire ou un bruit excessif peuvent entraîner un **échec du clonage** ou un **résultat de génération de mauvaise qualité**
>   **Restrictions d'utilisation**
> * Les personnages vocaux créés par le téléchargement d'audio sont des **ressources privées**
> * Ce personnage vocal **ne prend pas en charge la réutilisation entre comptes**
> * Il est conseillé de l'utiliser rapidement après sa création, une longue période sans utilisation peut entraîner une **expiration ou une indisponibilité**
> * Le `name` retourné est généré automatiquement par le système, veuillez vous référer au `persona_id` retourné

> **En cas d'échec de l'appel, veuillez d'abord réessayer**
> Le clonage de voix est une tâche gourmande en ressources, même si le matériau est entièrement conforme, il existe une certaine probabilité d'échec sporadique, des retours courants comme `voices_sound_different` (vérification de la voix non réussie) peuvent survenir. **Ces échecs ne sont pas liés à la qualité audio, réessayer avec le même matériau réussit généralement**,
> il est conseillé d'implémenter 1 à 2 tentatives automatiques en cas de résultats d'échec lors de l'intégration. Les demandes échouées ne seront pas facturées.

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
  "name": "Ma Voix",
  "description": "Exemple de voix humaine claire"
}'
```

> L'URL `https://cdn.acedata.cloud/suno_demo.mp3` est un matériau d'exemple directement appelable (MP3, 41 secondes, voix humaine claire).
> Pour un exemple au format `WAV`, vous pouvez utiliser
> `https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765` (WAV, 41 secondes, mono 44.1kHz).

Le résultat est le suivant :

```json theme={null}
{
  "success": true,
  "task_id": "0fa609a6-c8d9-4bb5-8574-e4c93bb55d02",
  "data": {
    "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16",
    "name": "VOICE_20260803037676",
    "is_public": false
  }
}
```

On peut voir que le champ `persona_id` dans `data` est l'ID du personnage vocal créé. Le champ `is_public` est toujours `false`, car les personnages vocaux créés par le téléchargement d'audio sont privés. Notez que le `name` retourné est généré automatiquement par le système, veuillez utiliser le `persona_id` pour référencer ce personnage vocal par la suite.

## Étape 2 : Utiliser le personnage vocal pour générer de la musique

Une fois que nous avons l'ID du personnage vocal, nous pouvons utiliser l'[API de génération de musique Suno](https://platform.acedata.cloud/documents/suno-audios) pour générer de la musique. Définissez `action` sur `generate` et `persona_id` sur l'ID du personnage vocal retourné ci-dessus, la chanson générée sera chantée avec la voix clonée.

> **Remarque :** Le clonage de voix ne prend en charge que les modèles `chirp-v4-5` et supérieurs (comme `chirp-v4-5`, `chirp-v5`, `chirp-v5-5`), ne prend pas en charge `chirp-v4`.

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "Une chanson synth-pop chaleureuse sur les nuits en ville",
  "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16"
}'
```

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": "Une chanson synth-pop chaleureuse sur les nuits en ville",
      "duration": 156.28
    }
  ]
}
```

On peut voir que la chanson générée a été 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.