API för att lägga till ett spår

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

Beskrivning av ändpunkten

Att lägga till ett spår kompletterar en befintlig låt med ett visst instrument eller en viss kanal, till exempel trummor, bas, stråkar eller en stämkanal.

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

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-stem \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "stem_control_tags": "add Drums",
    "song_title": "Tillagda trummor",
    "wait_completion": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Tillagda trummor",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Tillagda trummor",
        "status": "pending"
      }
    ]
  }
}

Ett anrop ger 2 resultat (debiteras som 2 låtar); exemplet visar 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

• stem_control_tags måste vara icke-tom text på en rad; radbrytningar och tabbar får inte förekomma och gränsen är 120 tecken.
• Att lägga till ett spår är inte samma sak som separering: separering delar upp en låt i sång, komp eller flera spår — använd API för separering (sång och komp).