API di remaster (Remaster)

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

Il remaster rigenera un brano già completato come «versione rimasterizzata» con qualità audio migliore. Restituisce 2 versioni in una volta e l'upstream aggiunge automaticamente (Remastered) al titolo.

Endpoint: POST /api/music/remaster

Fatturazione: A pagamento, fatturato in base al modello richiesto (per impostazione predefinita suno-v6, 0,6 CNY per chiamata); l'importo effettivamente addebitato segue la configurazione prezzi del back-office.

Sul modello: il remaster usa un endpoint upstream dedicato e un modello di remaster dedicato, fissati dalla piattaforma e che non cambiano con model; il model nella richiesta serve solo al prezzo e alla scelta del canale, e si consiglia di passare esplicitamente suno-v6.

Tempi di attesa e timeout (importante): è un endpoint sincrono — l'ordine viene accettato e passato al remaster solo quando arriva la risposta. Imposta il timeout del client a 300 secondi o più; nessuna risposta non significa che non sia stato rimasterizzato nulla, e non ritentare subito dopo un timeout (duplica l'ordine e riaddebita). Se la connessione è caduta, verifica più tardi con GET /api/music/songs.

Autenticazione

Parametri della richiesta

audio_id, source_clip_id e sourceClipId sono forme equivalenti di song_id; usane una qualsiasi.

Esempio di richiesta

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

Se ti bastano i valori predefiniti, invia solo il brano di origine: equivale a variation_category: normal + style_profile: boost:

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

Risposta

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Titolo del brano di origine (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Titolo del brano di origine (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Una chiamata restituisce 2 versioni rimasterizzate. Salva entrambi i clips[].song_id e interroga l'API di consultazione e cronologia dei brani fino a complete prima di scaricare l'audio.

Note

• Il brano di origine deve essere completato e rientrare nell'ambito di accesso della chiave API corrente; il materiale di origine esterno viene sincronizzato automaticamente sull'account che esegue.
• Il remaster rifà solo la qualità audio: per cambiare stile, arrangiamento o voce usa potenziamento dello stile, carica e fai il cover o gli endpoint Remix.
• Più alto è variation_category, più la versione rimasterizzata differisce dal brano di origine; prima di una consegna reale, prova con normal e poi alza.