Suno API di clonazione vocale - Istruzioni per l'integrazione

​

Primo passo: Creare un ruolo vocale

Requisiti per il file audio

• Il formato audio deve essere WAV o MP3
• La durata audio deve essere compresa tra 10 e 240 secondi, si consiglia di utilizzare materiale di voce singola pulita di 30-60 secondi
• L’audio deve contenere voce chiara e riconoscibile di una persona che parla o canta
• Si prega di evitare rumori di fondo, accompagnamenti, echi, riverberi; le canzoni complete con accompagnamento di solito non superano la verifica della voce
• Non includere più parlanti o voci multiple
• Materiale con volume troppo basso, voce poco chiara o rumore eccessivo potrebbe causare fallimenti nella clonazione o risultati di bassa qualità Limitazioni d’uso
• I ruoli vocali creati tramite l’upload audio sono risorse private
• Questo ruolo vocale non supporta il riutilizzo tra account
• Si consiglia di utilizzarlo il prima possibile dopo la creazione, un lungo periodo di inattività potrebbe causare scadenza o non disponibilità
• Il name restituito è generato automaticamente dal sistema, fare riferimento al persona_id restituito

In caso di fallimento della chiamata, si prega di riprovare La clonazione vocale è un compito intensivo in termini di calcolo, anche se il materiale è completamente conforme, esiste una certa probabilità di fallimenti occasionali, come il ritorno di voices_sound_different (verifica della voce non superata). Questi fallimenti non sono correlati alla qualità audio, riprovare con lo stesso materiale di solito porta al successo, si consiglia di implementare 1-2 tentativi automatici in caso di risultati di fallimento. Le richieste fallite non verranno addebitate.

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": "La mia Voce",
  "description": "Esempio di voce chiara di una persona"
}'

L’URL https://cdn.acedata.cloud/suno_demo.mp3 è un materiale di esempio direttamente utilizzabile (MP3, 41 secondi, voce singola pulita). Se hai bisogno di un esempio in formato WAV, puoi utilizzare https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765 (WAV, 41 secondi, 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
  }
}

​

Secondo passo: Utilizzare il ruolo vocale per generare musica

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": "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://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "Una calda canzone synth-pop sulle notti in città",
      "duration": 156.28
    }
  ]
}