API voor het verwijderen van een sectie
Beschrijving van het endpoint
Het verwijderen van een sectie wist één tijdsbereik uit een bestaand nummer en voegt de resterende delen samen tot een nieuwe versie.
Endpoint: POST /api/music/remove-section
Facturering: Betaald, gefactureerd op basis van het opgevraagde model; het werkelijk afgeschreven bedrag volgt de prijsconfiguratie in de back-office.
Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.
Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd en aan generatie overgedragen wanneer het antwoord binnenkomt. Gemeten: de meeste verzoeken antwoorden in 1-3 seconden, ongeveer 10% duurt langer dan 30 seconden en de langste is ongeveer 230 seconden. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is gegenereerd, en probeer niet direct na een timeout opnieuw (dat dupliceert de opdracht en rekent opnieuw af). Als de verbinding wegviel, controleer later met
GET /api/music/songs. Zie "Wachttijden en timeout-instellingen" in het Overzicht van de nieuwe API.
Authenticatie
| Parameter | Type | Verplicht | Opmerkingen |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Verzoekparameters
| Parameter | Type | Verplicht | Standaard | Opmerkingen |
|---|---|---|---|---|
| model | string | ja | - | Modelnaam voor klanten: suno-v6, suno-v6-wild of suno-v6-mini |
| source_clip_id | string | ja | - | De echte song_id van het bronnummer; het moet afgerond en toegankelijk zijn voor de huidige API-sleutel |
| crop_start_s | number | ja | - | Startseconde van het te verwijderen bereik; moet 0 of groter zijn |
| crop_end_s | number | ja | - | Eindseconde van het te verwijderen bereik; moet groter zijn dan crop_start_s |
| song_title | string | nee | - | Titel van het resultaat |
Voorbeeldverzoek
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": "Versie met verwijderde sectie"
}'
Antwoord
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Versie met verwijderde sectie",
"status": "processing"
}
]
}
}
Eén aanroep levert 1 resultaat (bewerkingsacties maken geen 2 nummers). Bewaar clips[].song_id en poll de API voor nummeropvraging tot de status completed is.
Opmerkingen
- Het verwijderde bereik moet voldoen aan
0 <= crop_start_s < crop_end_sen binnen de duur van het bronnummer liggen. - Gebruik de Crop-API als u een bereik wilt behouden in plaats van verwijderen.
Een API-sleutel aanvragen
Maak na je registratie een API-sleutel aan in de console. Elke generatie kost ¥0,6 en levert 2 nummers op, downloads zijn onbeperkt en een telefoonnummer is niet nodig.
API-sleutel ophalen Terug naar overzicht