Replace Section-API (deel vervangen)

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

Beschrijving van het endpoint

Replace Section regenereert ter plaatse één tijdsbereik van een bestaand nummer. Het is bedoeld om een regel songtekst te corrigeren of een passage te vervangen.

Endpoint: POST /api/music/replace-section

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

startSeconds en endSeconds zijn in seconden en accepteren decimalen; startSeconds moet kleiner zijn dan endSeconds en het bereik moet binnen de duur van het originele nummer liggen. requestedAt wordt alleen gebruikt als u de verzoekstijd moet doorgeven, als Unix-tijdstempel in seconden (niet milliseconden); meestal kan het worden weggelaten.

Vervangen is ook een asynchrone taak. De teruggegeven clip kan beginnen in pending, en een leeg audioadres is dan normaal; gebruik de teruggegeven echte song_id om het eindresultaat op te vragen.

Lengte van het deel: minstens 2 seconden (belangrijk)

Het te vervangen bereik mag niet korter zijn dan 2 seconden. Gemeten: bereiken van 1,0 / 1,2 / 1,5 seconde mislukten alle, terwijl 2,0 seconde en meer werkten.

Is het bereik te kort, dan antwoordt het platform niet met een "parameterfout" maar met een makkelijk verkeerd te lezen melding:

{"error":{"message":"You don't have access to this model. Upgrade your plan to use it.",
          "type":"bad_response_status_code","code":"bad_response_status_code"}}

Die zin is geen account- of abonnementsprobleem — het deel is te kort. Maak het bereik langer dan 2 seconden en dien opnieuw in.

Voorbeeldverzoek

curl -X POST https://www.suno-api.io/api/music/replace-section \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "startSeconds": 30,
    "endSeconds": 45,
    "contextLyrics": "volledige contexttekst",
    "contextWindowLyrics": "contexttekst van het venster",
    "infillLyrics": "vervangende tekst",
    "style": "Mandopop, acoustic",
    "title": "Vervangen versie",
    "negativeTags": "noise"
  }'

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "replace_clip_id",
        "song_title": "Vervangen versie",
        "status": "pending"
      }
    ],
    "replaceTask": "infill",
    "clipId": "clip_id",
    "source_update": {}
  }
}

Compatibele velden

• audioId / audio_id / clipId / clip_id
• startSeconds / start_seconds / infillStartS / infill_start_s
• endSeconds / end_seconds / infillEndS / infill_end_s
• infillLyrics / infill_lyrics / replacementLyrics / replacement_lyrics
• style / tags
• negativeTags / negative_tags