Suno API de clonage de voix Documentation

​

Étape 1 : Créer un 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.

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

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

​

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

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.

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"
}'

{
  "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
    }
  ]
}