API för att ta bort sång
Beskrivning av ändpunkten
Borttagning av sång delar upp en befintlig låt i två spår: sång och komp. Det är den kortare formen av separering: du anger bara källlåtens ID, inget separeringsläge behöver väljas och servern behandlar alltid som två spår (two).
Ändpunkt: POST /api/music/vocal-removal
Fakturering: Kostnadsfritt. Den här ändpunkten delar bara upp spår; den medför ingen genereringskostnad och skriver ingen debiteringspost.
Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.
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ällåten; den måste vara klar och åtkomlig för den aktuella API-nyckeln |
| source_audio_url | string | nej | - | Adress till källjudet (tillhör källan ett annat konto sköter servern vidarebefordran; klienten behöver inte skicka den) |
| source_file_name | string | nej | - | Källfilens namn; används bara i loggar och visning |
| song_title | string | nej | - | Prefix för resultatets titel; som standard behålls källåtens titel |
Kompatibla alias: sourceClipId, audio_id, audioId och song_id kan användas i stället för source_clip_id.
Exempelbegäran
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": "Borttagning av sång"
}'
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "vocals_clip_id",
"song_title": "Borttagning av sång (Vocals)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
},
{
"song_id": "instrumental_clip_id",
"song_title": "Borttagning av sång (Instrumental)",
"status": "pending",
"stem_from_id": "source_song_id",
"stem_mode": "two"
}
]
}
}
En inlämning ger 2 versioner × {Vocals, Instrumental}, så clips innehåller oftast 4 poster. Gruppera efter stem_from_id och skilj sång från komp på suffixet i song_title.
Noter
- Fråga de resulterande spåren med API för låtfrågor och historik (
POST /api/music/query) tills statusen ärcompletedinnan du använder dem;GET /api/music/songs/:song_idoch historiklistan innehåller för närvarande inte de spår som borttagning av sång skapar — det är en känd skillnad. - Vill du välja tvåspårs- eller flerspårsläge, eller dela upp efter spårnamn, använd API för separering (sång och komp).
- Oönskade spår kan döljas med API för att ta bort ett spår; skicka inte upprepade borttagningsbegäranden.
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