API Extend (estensione)

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

Descrizione dell'endpoint

Extend prolunga un brano esistente da un punto temporale scelto e genera il passaggio successivo.

Endpoint: POST /api/music/extend

Fatturazione: A pagamento, attualmente 0,6 ¥ per chiamata per impostazione predefinita. L'importo effettivamente addebitato segue la configurazione prezzi attuale del back-office.

Max Mode / Variety: questo endpoint supporta i parametri opzionali max_mode e variety (0-4). Con max_mode attivo, questa chiamata viene fatturata al doppio del prezzo (0,6 → 1,2 ¥ per chiamata); variety non costa nulla in più. Significato e modalità di invio sono nella sezione «Parametri avanzati» della Panoramica della nuova API.

Tempi di attesa e timeout (importante): è un endpoint sincrono — l'ordine viene accettato e passato alla generazione solo quando arriva la risposta. Dai dati misurati, la maggior parte delle richieste risponde in 1-3 secondi, circa il 10% supera i 30 secondi e la più lunga arriva a circa 230 secondi. Imposta il timeout del client a 300 secondi o più; nessuna risposta non significa che non sia stato generato 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. Vedi «Tempi di attesa e impostazione del timeout» nella Panoramica della nuova API.

Parametri della richiesta

Headers

Parametri del body

Esempio di richiesta

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": "prosegui il ritornello con più intensità",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Versione estesa",
    "waitAudio": false
  }'

Risposta

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

Campi compatibili

I vecchi nomi restano accettati:

Note

• Non partire attaccato alla fine: la durata dell'estensione è in pratica «ciò che resta dopo il punto di partenza». Se il punto di partenza è troppo vicino alla fine, il risultato è di pochi secondi — misurato, un brano di 242 secondi esteso dal secondo 240 ha prodotto solo 2,7 secondi (e la chiamata viene addebitata comunque). Lascia almeno 10 secondi dopo il punto di partenza.
• Extend non ha una soglia «sorgente troppo corta»: misurato, una clip di 9,6 secondi estesa dal secondo 5 ha prodotto un brano normalmente, quindi una sorgente corta o un resto corto non sono motivi di rifiuto.
• Il punto di partenza deve essere maggiore di 0: continueAt=0 viene accettato dalla piattaforma e poi annullato, senza restituire il motivo del fallimento; inizia quindi subito dopo il primo secondo.
• Una chiamata restituisce 2 risultati (fatturati come 2 brani); fai riferimento alla lunghezza dell'array clips.
• Il risultato è un nuovo lavoro; il brano originale non viene toccato.