Get Full Song-API (volledig nummer samenstellen)

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Volledig nummer samenstellen voegt "het originele nummer + het nieuw gegenereerde fragment" samen tot één compleet nummer: na Extend wordt het volgende deel aangehecht, na Replace Section wordt het nieuwe fragment weer in het origineel genaaid. De officiële webinterface noemt deze functie Get Full Song.

Endpoint: POST /api/music/concat

Facturering: Betaald, vast 0,05 CNY per aanroep. Het samenstellen staat los van de generatieprijs en doet niet mee aan Max Mode of aan stemprofiel-multipliers; het daadwerkelijk afgeschreven bedrag volgt de prijsconfiguratie in de backoffice.

Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd en aan het samenstellen overgedragen wanneer het antwoord binnenkomt. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is samengesteld, en probeer niet direct na een timeout opnieuw (dat dupliceert de opdracht en rekent opnieuw af). Als de verbinding wegviel, controleer later met GET /api/music/songs.

Authenticatie

Parameter	Type	Verplicht	Opmerkingen
Authorization	string	ja	`Bearer YOUR_API_KEY`
Content-Type	string	ja	`application/json`

Verzoekparameters

Parameter	Type	Verplicht	Standaard	Opmerkingen
song_id	string	ja	-	De `song_id` van het samen te stellen fragment (resultaat van Extend of Replace Section); het moet voltooid zijn
is_infill	boolean	nee	false	`false` = samenstellen van een verlenging; `true` = samenstellen van een vervanging (infill)
source_audio_url	string	nee	-	Adres van de bronaudio, wanneer het fragment van een extern account komt
source_file_name	string	nee	-	Naam van het bronbestand, wanneer het fragment van een extern account komt
source_title	string	nee	-	Brontitel, wanneer het fragment van een extern account komt

audio_id, source_clip_id en sourceClipId zijn gelijkwaardige schrijfwijzen van song_id; gebruik er één.

Voorbeeldverzoek

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
  }'

Om na het vervangen van een sectie samen te stellen, zet u is_infill op true:

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

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "concat_clip_id",
        "song_title": "Titel van het bronnummer",
        "status": "queued"
      }
    ]
  }
}

Het samenstellen levert slechts 1 resultaat op (er komen niet in één keer 2 nummers). Sla clips[].song_id op en bevraag de API voor nummeropvraging en geschiedenis tot complete voordat u de audio ophaalt.

Waar de duur van het resultaat vandaan komt

Bij het samenstellen worden niet simpelweg twee bestanden achter elkaar gezet; het bronnummer wordt bijgesneden op basis van de tijdpunten die in de geschiedenis van het fragment zijn vastgelegd:

Modus	Opbouw van het resultaat
`is_infill: false`	bronnummer `[0 .. continue_at]` + de volledige lengte van het verlengingsfragment
`is_infill: true`	bronnummer `[0 .. begin]` + het vervangen nieuwe fragment + bronnummer `[einde .. einde van de track]`

De originele audio ná het voortzettingspunt wordt dus weggegooid, zodat nooit een heel deel dubbel voorkomt.

Opmerkingen

Alleen voltooide fragmenten kunnen worden samengesteld; wacht bij een nog genererend fragment tot het klaar is.
Het resultaat is een nieuwe record; het oorspronkelijke fragment blijft bestaan en blijft bruikbaar.
Om twee verschillende nummers tot één te maken gebruikt u de mashup-API; om slechts één deel te behouden de bijsnijd-API.

VolgendeRemaster-API

Een API-sleutel aanvragen

Maak na je registratie een API-sleutel aan in de console. Elke generatie kost ¥0,6 en levert 2 nummers op, downloads zijn onbeperkt en een telefoonnummer is niet nodig.

API-sleutel ophalen Terug naar overzicht