Mashup-API

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

Beskrivning av ändpunkten

En mashup kombinerar två färdiga låtar till ett nytt verk; ordningen på de två källorna bevaras.

Ändpunkt: POST /api/music/mashup

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/mashup \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "mashup_clip_ids": ["source_song_id_a", "source_song_id_b"],
    "style_tags": "electronic pop, energetic",
    "song_title": "Mashup-version",
    "wait_completion": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Mashup-version",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Mashup-version",
        "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

• mashup_clip_ids måste innehålla exakt två olika riktiga låt-ID.
• Båda källorna måste vara klara och åtkomliga för den aktuella API-nyckeln; är en källa inte åtkomlig returneras ett fel före genereringen.