API för att lägga till komp (instrumental)

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

Beskrivning av ändpunkten

Att lägga till komp arrangerar om en befintlig låt, fyller på med instrument eller skapar en ny kompstruktur.

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

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-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "Version med förstärkt komp",
    "audio_weight": 1,
    "wait_completion": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Version med förstärkt komp",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Version med förstärkt komp",
        "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. Därefter kan du spela upp eller ladda ner via audio_url; se API för att generera och hämta WAV och övriga nedladdningsändpunkter.

Noter

• source_clip_id måste vara ett riktigt, färdigt låt-ID som är åtkomligt för den aktuella API-nyckeln; ett platshållar-ID som pending: kan inte användas.
• Att lägga till komp är inte en cover; behöver du en cover använder du API för cover från ett källklipp.
• Vill du lägga till ett specifikt instrument eller en specifik kanal i en befintlig låt använder du API för att lägga till kanal.