Crop-API (beskära)

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

Beskrivning av ändpunkten

Crop behåller ett tidsintervall i en befintlig låt och skapar en ny, beskuren version.

Ändpunkt: POST /api/music/crop

Fakturering: Betalt, debiteras efter den begärda modellen; det faktiskt debiterade beloppet följer prisinställningen i backoffice.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

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.

Autentisering

Begäransparametrar

Exempelbegäran

curl -X POST https://www.suno-api.io/api/music/crop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "crop_start_s": 10,
    "crop_end_s": 48,
    "song_title": "Beskuren version"
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Beskuren version",
        "status": "processing"
      }
    ]
  }
}

Ett anrop ger 1 resultat (redigeringsåtgärder skapar inte 2 låtar). Spara clips[].song_id och polla API för låtfrågor tills statusen är completed. Ibland har det första svaret ännu inte registrerat ett frågbart song_id; vänta en stund och fråga igen.

Noter

• Intervallet som behålls måste uppfylla 0 <= crop_start_s < crop_end_s och ligga inom källlåtens längd.
• Till skillnad från beskärning använder du API för att ta bort avsnitt för att ta bort en passage.