API Extend (prelungire)

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

Descrierea endpoint-ului

Extend continuă o piesă existentă dintr-un moment ales și generează pasajul următor.

Endpoint: POST /api/music/extend

Facturare: Cu plată, momentan implicit 0,6 ¥ per apel. Suma efectiv debitată urmează configurația actuală de prețuri din back-office.

Max Mode / Variety: acest endpoint acceptă parametrii opționali max_mode și variety (0-4). Cu max_mode activat, acest apel este facturat la dublu (0,6 → 1,2 ¥ per apel); variety nu costă nimic în plus. Ce înseamnă și cum se trimit este în secțiunea „Parametri avansați” din Prezentarea noului API.

Timpii de așteptare și timeout-urile (important): este un endpoint sincron — comanda este acceptată și transmisă spre generare doar când sosește răspunsul. Din măsurători, majoritatea cererilor răspund în 1-3 secunde, circa 10% depășesc 30 de secunde, iar cea mai lungă este de aproximativ 230 de secunde. Setează timeout-ul clientului la 300 de secunde sau mai mult; lipsa unui răspuns nu înseamnă că nu s-a generat 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. Vezi „Timpii de așteptare și setarea timeout-ului” în Prezentarea noului API.

Parametrii cererii

Headers

Parametri din body

Exemplu de cerere

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": "continuă refrenul cu mai multă intensitate",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Versiune extinsă",
    "waitAudio": false
  }'

Răspuns

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Versiune extinsă",
        "status": "pending"
      }
    ]
  }
}

Câmpuri compatibile

Numele vechi sunt încă acceptate:

Note

• Nu începe lipit de final: lungimea prelungirii este practic „ce rămâne după punctul de start”. Când punctul de start este prea aproape de final, rezultatul are doar câteva secunde — măsurat, o piesă de 242 de secunde prelungită de la secunda 240 a produs doar 2,7 secunde (și apelul se facturează oricum). Lasă cel puțin 10 secunde după punctul de start.
• Extend nu are prag de „sursă prea scurtă”: măsurat, un clip de 9,6 secunde prelungit de la secunda 5 a produs normal o piesă, deci o sursă scurtă sau un rest scurt nu sunt motive de refuz.
• Punctul de start trebuie să fie mai mare decât 0: continueAt=0 este acceptat de platformă și apoi anulat, fără să returneze motivul eșecului, deci începe imediat după prima secundă.
• Un apel returnează 2 rezultate (facturate ca 2 piese); ghidează-te după lungimea array-ului clips.
• Rezultatul este o operă nouă; piesa originală nu este afectată.