Extend-API (verlengen)

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

Beschrijving van het endpoint

Extend vervolgt een bestaand nummer vanaf een gekozen tijdstip en genereert de volgende passage.

Endpoint: POST /api/music/extend

Facturering: Betaald, momenteel standaard 0,6 ¥ per aanroep. Het werkelijk gefactureerde bedrag volgt de huidige prijsconfiguratie in de back-office.

Max Mode / Variety: dit endpoint ondersteunt de optionele parameters max_mode en variety (0-4). Met max_mode aan wordt deze aanroep tegen het dubbele tarief gefactureerd (0,6 → 1,2 ¥ per aanroep); variety kost niets extra. Wat ze betekenen en hoe u ze verstuurt, staat in de sectie "Geavanceerde parameters" van het Overzicht van de nieuwe API.

Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd en aan generatie overgedragen wanneer het antwoord binnenkomt. Gemeten: de meeste verzoeken antwoorden in 1-3 seconden, ongeveer 10% duurt langer dan 30 seconden en de langste is ongeveer 230 seconden. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is gegenereerd, 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. Zie "Wachttijden en timeout-instellingen" in het Overzicht van de nieuwe API.

Verzoekparameters

Headers

Body-parameters

Voorbeeldverzoek

curl -X POST https://www.suno-api.io/api/music/extend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "prompt": "vervolg het refrein met meer intensiteit",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Verlengde versie",
    "waitAudio": false
  }'

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Verlengde versie",
        "status": "pending"
      }
    ]
  }
}

Compatibele velden

De oude veldnamen worden nog steeds geaccepteerd:

Opmerkingen

• Begin niet pal aan het einde: de lengte van de verlenging is in feite "wat er na het startpunt overblijft". Ligt het startpunt te dicht bij het einde, dan bestaat het resultaat uit enkele seconden — gemeten leverde een nummer van 242 seconden, verlengd vanaf seconde 240, slechts 2,7 seconden op (en de aanroep wordt alsnog gefactureerd). Laat minstens 10 seconden na het startpunt.
• Extend heeft geen drempel "bron te kort": gemeten leverde een clip van 9,6 seconden, verlengd vanaf seconde 5, gewoon een nummer op; een korte bron of een kort restant is dus geen reden tot weigering.
• Het startpunt moet groter dan 0 zijn: continueAt=0 wordt door het platform geaccepteerd en daarna ongeldig verklaard, zonder reden van mislukking; begin dus direct na de eerste seconde.
• Eén aanroep levert 2 resultaten op (gefactureerd als 2 nummers); kijk naar de lengte van de clips-array.
• Het resultaat is nieuw werk; het originele nummer blijft onaangetast.