API voor het verwijderen van zang
Beschrijving van het endpoint
Stemverwijdering splitst een bestaand nummer in twee tracks: zang en begeleiding. Het is de verkorte vorm van scheiding: u geeft alleen de ID van het bronnummer door, u hoeft geen scheidingsmodus te kiezen en de server verwerkt altijd als twee tracks (two).
Endpoint: POST /api/music/vocal-removal
Facturering: Gratis. Dit endpoint splitst alleen tracks; het kost niets aan generatie en er wordt geen factuurregel geschreven.
Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.
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 voltooid zijn en toegankelijk voor de huidige API-sleutel |
| source_audio_url | string | nee | - | Adres van de bronaudio (hoort de bron bij een ander account, dan doet de server het doorgeven; de client hoeft dit niet te sturen) |
| source_file_name | string | nee | - | Naam van het bronbestand; alleen voor logs en weergave |
| song_title | string | nee | - | Prefix van de resultaattitel; standaard blijft de titel van het bronnummer behouden |
Compatibele aliassen: sourceClipId, audio_id, audioId en song_id mogen in plaats van source_clip_id worden gebruikt.
Voorbeeldverzoek
curl -X POST https://www.suno-api.io/api/music/vocal-removal \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"song_title": "Stemverwijdering"
}'
Antwoord
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "vocals_clip_id",
"song_title": "Stemverwijdering (Vocals)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
},
{
"song_id": "instrumental_clip_id",
"song_title": "Stemverwijdering (Instrumental)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
}
]
}
}
Eén inzending levert 2 versies × {Vocals, Instrumental}, dus clips bevat meestal 4 items. Groepeer op stem_from_id en onderscheid zang en begeleiding aan het achtervoegsel van song_title.
Opmerkingen
- Bevraag de resulterende tracks met de API voor nummeropvraging en geschiedenis (
POST /api/music/query) totcompletedvoordat u ze gebruikt;GET /api/music/songs/:song_iden de geschiedenislijst bevatten momenteel niet de tracks die door stemverwijdering zijn gemaakt — dat is een bekend verschil. - Wilt u de twee-track- of meertrackmodus kiezen of op tracknaam splitsen, gebruik dan de API voor scheiding (zang en begeleiding).
- Ongewenste tracks kunt u verbergen met de API voor het verwijderen van een track; stuur geen herhaalde verwijderverzoeken.
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