Get Full Song-API (sammanfoga hela låten)

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

Beskrivning av ändpunkten

Sammanfogning till hel låt sätter ihop "originallåten + det nygenererade fragmentet" till en enda komplett låt: efter Extend läggs nästa avsnitt till, och efter Replace Section sys det nya fragmentet tillbaka i originalet. Det officiella webbgränssnittet kallar funktionen Get Full Song.

Ändpunkt: POST /api/music/concat

Fakturering: Betalt, fast 0,05 CNY per anrop. Sammanfogningen är frikopplad från genereringspriset och deltar inte i Max Mode eller i multiplikatorer för röstprofiler; det faktiskt debiterade beloppet följer prisinställningen i backoffice.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till sammanfogning först när svaret kommer. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget fogades samman, 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.

Autentisering

Parameter	Typ	Krävs	Anmärkningar
Authorization	string	ja	`Bearer YOUR_API_KEY`
Content-Type	string	ja	`application/json`

Begäransparametrar

Parameter	Typ	Krävs	Standard	Anmärkningar
song_id	string	ja	-	`song_id` för fragmentet som ska fogas samman (resultat av Extend eller Replace Section); det måste vara klart
is_infill	boolean	nej	false	`false` = sammanfogning av förlängning; `true` = sammanfogning av ersättning (infill)
source_audio_url	string	nej	-	Adress till källjudet, när fragmentet kommer från ett externt konto
source_file_name	string	nej	-	Källfilens namn, när fragmentet kommer från ett externt konto
source_title	string	nej	-	Källtitel, när fragmentet kommer från ett externt konto

audio_id, source_clip_id och sourceClipId är likvärdiga stavningar av song_id; använd någon av dem.

Exempelbegäran

curl -X POST https://www.suno-api.io/api/music/concat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "extended_or_replaced_clip_id",
    "is_infill": false
  }'

För att sammanfoga efter att ha ersatt ett avsnitt, sätt is_infill till true:

{ "song_id": "infilled_clip_id", "is_infill": true }

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "concat_clip_id",
        "song_title": "Källåtens titel",
        "status": "queued"
      }
    ]
  }
}

Sammanfogningen ger bara 1 resultat (den skapar inte 2 låtar på en gång). Spara clips[].song_id och fråga API för låtfrågor och historik tills statusen är complete innan du hämtar ljudet.

Varifrån resultatets längd kommer

Sammanfogningen lägger inte bara två filer efter varandra; den beskär källlåten efter de tidpunkter som finns i fragmentets historik:

Läge	Resultatets sammansättning
`is_infill: false`	källlåten `[0 .. continue_at]` + hela längden av förlängningsfragmentet
`is_infill: true`	källlåten `[0 .. start]` + det ersatta nya fragmentet + källlåten `[slut .. spårets slut]`

Originalljudet efter fortsättningspunkten kastas alltså bort, så inget avsnitt dupliceras i sin helhet.

Noter

Endast färdiga fragment kan fogas samman; vänta tills ett fragment som fortfarande genereras är klart.
Resultatet är en ny post; det ursprungliga fragmentet finns kvar och är fortfarande användbart.
För att slå ihop två olika låtar till en, använd mashup-API:t; för att behålla bara ett avsnitt, använd beskärnings-API:t.

NästaRemaster-API

Skaffa en API-nyckel

Skapa en API-nyckel i konsolen efter registreringen. Varje generering kostar 0,6 ¥ och returnerar 2 spår, nedladdningar är obegränsade och inget telefonnummer krävs.

Hämta API-nyckel Tillbaka till översikten