API för att ta bort avsnitt
Beskrivning av ändpunkten
Att ta bort ett avsnitt raderar ett tidsintervall ur en befintlig låt och fogar samman de återstående delarna till en ny version.
Ändpunkt: POST /api/music/remove-section
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
| Parameter | Typ | Krävs | Anmärkningar |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Begäransparametrar
| Parameter | Typ | Krävs | Standard | Anmärkningar |
|---|---|---|---|---|
| model | string | ja | - | Modellnamn mot kund: suno-v6, suno-v6-wild eller suno-v6-mini |
| source_clip_id | string | ja | - | Den riktiga song_id för källlåten; den måste vara klar och nåbar med den aktuella API-nyckeln |
| crop_start_s | number | ja | - | Startsekund för intervallet som tas bort; måste vara 0 eller större |
| crop_end_s | number | ja | - | Slutsekund för intervallet som tas bort; måste vara större än crop_start_s |
| song_title | string | nej | - | Titel för resultatet |
Exempelbegäran
curl -X POST https://www.suno-api.io/api/music/remove-section \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"crop_start_s": 30,
"crop_end_s": 45,
"song_title": "Version med borttaget avsnitt"
}'
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Version med borttaget avsnitt",
"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.
Noter
- Intervallet som tas bort måste uppfylla
0 <= crop_start_s < crop_end_soch ligga inom källlåtens längd. - Använd Crop-API:t om du vill behålla ett intervall i stället för att ta bort det.
Skaffa en API-nyckel
Skapa en API-nyckel i konsolen efter registreringen. Varje generering kostar 0,6 ¥ och returnerar 2 spår, nedladdningar är obegränsade och inget telefonnummer krävs.
Hämta API-nyckel Tillbaka till översikten