API de remasterizare (Remaster)

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Remasterizarea regenerează o piesă finalizată ca «versiune remasterizată» cu o calitate audio mai bună. Returnează 2 versiuni deodată, iar upstreamul adaugă automat (Remastered) la titlu.

Endpoint: POST /api/music/remaster

Facturare: Cu plată, facturat în funcție de modelul cerut (implicit suno-v6, 0,6 CNY per apel); suma efectiv debitată urmează configurația de prețuri din back-office.

Despre model: remasterizarea folosește un endpoint upstream dedicat și un model de remasterizare dedicat, fixate de platformă și care nu depind de model; model din cerere servește doar la preț și alegerea canalului, așa că se recomandă trimiterea explicită a suno-v6.

Timpii de așteptare și timeout-urile (important): este un endpoint sincron — comanda este acceptată și transmisă spre remasterizare doar când sosește răspunsul. Setează timeout-ul clientului la 300 de secunde sau mai mult; lipsa unui răspuns nu înseamnă că nu s-a remasterizat nimic, iar reîncercarea imediat după un timeout dublează comanda și debitează din nou. Dacă conexiunea s-a întrerupt, verifică mai târziu cu GET /api/music/songs.

Autentificare

Parametrii cererii

audio_id, source_clip_id și sourceClipId sunt scrieri echivalente ale song_id; folosește una dintre ele.

Exemplu de cerere

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

Dacă valorile implicite sunt suficiente, trimite doar piesa sursă — echivalează cu variation_category: normal + style_profile: boost:

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

Răspuns

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Titlul piesei sursă (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Titlul piesei sursă (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Un apel returnează 2 versiuni remasterizate. Salvează ambele clips[].song_id și interoghează API de interogare a pieselor și de istoric până la complete înainte de a prelua audio-ul.

Note

• Piesa sursă trebuie să fie finalizată și să se afle în sfera de acces a cheii API curente; materialul sursă extern este sincronizat automat către contul care execută.
• Remasterizarea reface doar calitatea audio: pentru a schimba stilul, aranjamentul sau vocea, folosește intensificarea stilului, încărcare și cover sau endpoint-urile Remix.
• Cu cât variation_category este mai mare, cu atât versiunea remasterizată diferă mai mult de piesa sursă; înainte de o livrare reală, încearcă normal și apoi crește.