API för att lägga till sång

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Att lägga till sång genererar, skriver om eller kompletterar sången i en befintlig låt eller på en instrumental källa.

Ändpunkt: POST /api/music/add-vocal

Fakturering: Betalt, debiteras enligt den begärda modellen; det faktiskt debiterade beloppet följer prisinställningen i backoffice.

Max Mode / Variety: den här ändpunkten stöder de valfria parametrarna max_mode och variety (0-4). Med max_mode på debiteras anropet till dubbelt pris; variety kostar inget extra. Vad de betyder och hur de skickas står i avsnittet "Avancerade parametrar" i Översikt över det nya API:t.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till generering först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, och försök inte igen direkt efter en timeout (det duplicerar beställningen och debiterar igen). Om anslutningen bröts, kontrollera senare med GET /api/music/songs. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Autentisering

Begäransparametrar

Exempelbegäran

curl -X POST https://www.suno-api.io/api/music/add-vocal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "[Verse]\nNatten faller utanför fönstret\n[Chorus]\nVi går mot ljuset",
    "style_tags": "warm male vocal, mandopop, intimate",
    "song_title": "Version med förstärkt sång",
    "instrumental": false,
    "wait_completion": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Version med förstärkt sång",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Version med förstärkt sång",
        "status": "pending"
      }
    ]
  }
}

Ett anrop ger 2 resultat (debiteras som 2 låtar); i exemplet visas 2. Utgå från längden på clips-arrayen och använd inte ett fast antal iterationer. Spara clips[].song_id och fråga API för låtfrågor och historik tills statusen är completed.

Noter

• Att lägga till sång betyder "generera eller skriv om sången i källåten"; det är inte samma sak som inställningen vocal_gender.
• Vill du använda en klonad röst använder du 【Rekommenderas】 röstprofil-API:t; API för röstkloning och generering med angiven röst (den äldre kedjan) rekommenderas inte för nya integrationer.