Suno API-integrationsguide för röstkloning

​

Steg 1: Skapa en röstroll

Krav för ljudfiler

• Ljudformatet måste vara WAV eller MP3
• Ljudets längd måste vara mellan 10~240 sekunder, och det rekommenderas att använda 30~60 sekunder rent torrt ljudmaterial med en enskild röst
• Ljudet ska innehållatydligt, identifierbart tal eller sång från en enskild person
• Se till att undvikabakgrundsbrus, ackompanjemang, eko och efterklang; kompletta låtar med ackompanjemang kan vanligtvis inte klara röstavtrycksvalideringen
• Inkludera inteflera talareellerflera röster
• Material med för låg volym, otydligt tal eller för mycket brus kan leda tillmisslyckad kloningellersämre genereringsresultat Beskrivning av användningsbegränsningar
• Röstroller som skapas genom att ladda upp ljud ärprivata resurser
• Röstrollenstödjer inte återanvändning mellan konton
• Det rekommenderas att använda den så snart som möjligt efter att den har skapats; om den inte används under lång tid kan den bliogiltig eller otillgänglig
• Det returnerade name genereras automatiskt av systemet, använd det returnerade persona_id som referens

Försök igen först när anropet misslyckas Röstkloning är en beräkningsintensiv uppgift, och även om materialet är helt kompatibelt finns det en viss sannolikhet för tillfälliga fel, vanliga svar är till exempel voices_sound_different (röstavtrycksvalideringen misslyckades) och liknande. Denna typ av fel har inget att göra med ljudkvaliteten, och att försöka igen med samma material brukar lyckas, det rekommenderas att implementera 1~2 automatiska återförsök för misslyckade resultat vid integrering. Misslyckade förfrågningar debiteras inte.

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": "My Voice",
  "description": "单人清晰人声示例"
}'

Ovanstående https://cdn.acedata.cloud/suno_demo.mp3 är exempelmaterial som kan anropas direkt (MP3, 41 sekunder, torr röst från en enskild person). Om du behöver ett exempel i WAV-format kan du använda https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765 (WAV, 41 sekunder, mono 44,1 kHz).

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

​

Steg 2: Använd röstrollen för att generera musik

Observera: Röstkloning stöder endast modellerna chirp-v4-5 och högre (såsom chirp-v4-5, chirp-v5, chirp-v5-5), och stöder inte 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": "A warm synth-pop song about city nights",
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}

{
  "action": "upload_cover",
  "model": "chirp-v6",
  "audio_id": "<与该声音关联上传后返回的 audio_id>",
  "persona_id": "<声音创建接口返回的 persona_id>",
  "custom": true,
  "instrumental": false,
  "lyric": "[Verse]\n填写要演唱的歌词",
  "async": true
}