Extend-API (förlängning)

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Extend fortsätter en befintlig låt från en vald tidpunkt och genererar nästa avsnitt.

Ändpunkt: POST /api/music/extend

Fakturering: Betalt, för närvarande som standard 0,6 ¥ per anrop. Det faktiskt debiterade beloppet följer den aktuella prisinställningen i backoffice.

Max Mode / Variety: den här ändpunkten stöder de valfria parametrarna max_mode och variety (0-4). Med max_mode på debiteras anropet till dubbelt pris (0,6 → 1,2 ¥ per anrop); variety kostar inget extra. Vad de betyder och hur de skickas står i avsnittet "Avancerade parametrar" i Översikt över det nya API:t.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till generering först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, och försök inte igen direkt efter en timeout (det duplicerar beställningen och debiterar igen). Om anslutningen bröts, kontrollera senare med GET /api/music/songs. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Begäransparametrar

Headers

Brödtextparametrar

Exempelbegäran

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": "fortsätt refrängen med mer intensitet",
    "continueAt": 60,
    "style": "Mandopop, rock",
    "negativeTags": "noise",
    "title": "Förlängd version",
    "waitAudio": false
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "extended_clip_id",
        "song_title": "Förlängd version",
        "status": "pending"
      }
    ]
  }
}

Kompatibla fält

De gamla fältnamnen accepteras fortfarande:

Noter

• Börja inte direkt vid slutet: förlängningens längd är i praktiken "det som återstår efter startpunkten". Ligger startpunkten för nära slutet blir resultatet bara några sekunder — mätt gav en låt på 242 sekunder, förlängd från sekund 240, endast 2,7 sekunder (och anropet debiteras ändå). Lämna minst 10 sekunder efter startpunkten.
• Extend har ingen tröskel för "för kort källa": mätt gav ett klipp på 9,6 sekunder, förlängt från sekund 5, en låt som vanligt, så en kort källa eller en kort återstod är inte skäl för avslag.
• Startpunkten måste vara större än 0: continueAt=0 accepteras av plattformen och ogiltigförklaras sedan, utan att något skäl returneras; börja därför direkt efter första sekunden.
• Ett anrop ger 2 resultat (debiteras som 2 låtar); utgå från längden på clips-arrayen.
• Resultatet är ett nytt verk; originallåten påverkas inte.