Vai al contenuto principale

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 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.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": "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.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": "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.