Remaster-API

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

Beschrijving van het endpoint

Remaster regenereert een voltooid nummer als een "geremasterde versie" met betere audiokwaliteit. Het levert in één keer 2 versies op, en de upstream voegt automatisch (Remastered) aan de titel toe.

Endpoint: POST /api/music/remaster

Facturering: Betaald, gefactureerd volgens het opgevraagde model (standaard suno-v6, 0,6 CNY per aanroep); het daadwerkelijk afgeschreven bedrag volgt de prijsconfiguratie in de backoffice.

Over het model: remasteren gebruikt een toegewijde upstream-endpoint en een toegewezen remastermodel, door het platform vastgelegd en niet afhankelijk van model; het model in het verzoek dient alleen voor prijs en kanaalkeuze, en het is aan te raden suno-v6 expliciet mee te sturen.

Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd en aan het remasteren overgedragen wanneer het antwoord binnenkomt. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is geremasterd, 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

Verzoekparameters

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/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Als de standaardwaarden volstaan, stuurt u alleen het bronnummer mee — dat is gelijk aan variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Titel van het bronnummer (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Titel van het bronnummer (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Eén aanroep levert 2 geremasterde versies op. Sla beide clips[].song_id op en bevraag de API voor nummeropvraging en geschiedenis tot complete voordat u de audio ophaalt.

Opmerkingen

• Het bronnummer moet voltooid zijn en binnen het toegangsbereik van de huidige API-sleutel vallen; extern bronmateriaal wordt automatisch naar het uitvoerende account gesynchroniseerd.
• Remasteren doet alleen de audiokwaliteit opnieuw: om stijl, arrangement of zang te veranderen gebruikt u stijl versterken, uploaden en coveren of de Remix-endpoints.
• Hoe groter variation_category, hoe meer de geremasterde versie van het bronnummer afwijkt; probeer vóór een echte oplevering eerst normal en ga daarna hoger.