Vai al contenuto principale
SUNO ci consente di creare personaggi vocali personalizzati tramite qualsiasi file audio, realizzando la clonazione vocale per la generazione musicale. A differenza della Persona API esistente (che utilizza audio_id generato da Suno), questa API accetta un audio_url pubblicamente accessibile, cioè una registrazione vocale personale. Questo documento spiega come integrare l’API di clonazione vocale.

​
Primo passo: creare un personaggio vocale

Questa API ha tre parametri di input: audio_url (obbligatorio), che deve essere un URL pubblico di un file audio in formato MP3 o WAV contenente una voce singola chiara; name e description (opzionali), che rappresentano il nome e la descrizione del personaggio vocale. Requisiti del file audio:
  • Formato: MP3 o WAV
  • Durata: almeno 10 secondi
  • Contenuto: voce singola chiara, con rumore di fondo o musica ridotti al minimo
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": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "Esempio di registrazione vocale utente"
}'
Il risultato sarà: 
{
  "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
  }
}
Come si vede, il campo persona_id in data è l’ID del personaggio vocale creato. Il campo is_public è sempre false perché i personaggi vocali creati tramite upload audio sono privati.

​
Secondo passo: generare musica con il personaggio vocale

Con l’ID del personaggio vocale, possiamo utilizzare la Suno Audios Generation API per generare musica. Impostiamo action su generate e persona_id sull’ID del personaggio vocale ottenuto; la canzone generata sarà cantata con la voce clonata.
Nota: la clonazione vocale supporta solo modelli chirp-v4-5 e superiori (come chirp-v4-5, chirp-v5, chirp-v5-5), non supporta 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": "Una calda canzone synth-pop sulle notti in città",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
Il risultato sarà: 
{
  "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": "Una calda canzone synth-pop sulle notti in città",
      "duration": 156.28
    }
  ]
}
Come si vede, la canzone generata è cantata con la voce clonata. persona_id può anche essere usato con l’azione cover per reinterpretare canzoni esistenti con la voce clonata.