Usage Guide
- Separate a platform‑generated mix into vocal, instrumental, and individual instrument components.
- Two processing modes are available:
separate_vocal
— 2‑stem splitsplit_stem
— up to 12‑stem split
- Ideal for karaoke creation, remixes, sample extraction, or detailed post‑production.
- Best results on professionally mixed AI tracks with clear vocal and instrumental layers.
- Billing notice: Each call consumes credits; re‑calling the same track is charged again (no server‑side caching).
- Pricing: Check current per‑call credit costs at https://sunoapi.org/billing.
Separation Mode DetailsMode (type ) | Stems Returned | Typical Use | Credit Cost |
---|---|---|---|
separate_vocal (default) | 2 stems – Vocals + Instrumental | Quick vocal removal, karaoke, basic remixes | 1 music‑generation credit |
split_stem | Up to 12 stems – Vocals, Backing Vocals, Drums, Bass, Guitar, Keyboard, Strings, Brass, Woodwinds, Percussion, Synth, FX/Other | Advanced mixing, remixing, sound design | 5 music‑generation credits |
Parameter ReferenceName | Type | Description |
---|---|---|
taskId | string | ID of the original music‑generation task |
audioId | string | Which audio variation to process when multiple versions exist |
type | string | Required. Separation mode: separate_vocal or split_stem |
Developer Notes- All returned audio‑file URLs remain accessible for 14 days.
- Separation quality depends on the complexity and mixing of the original track.
separate_vocal
returns 2 stems — vocals + instrumental.split_stem
returns up to 12 independent stems — vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, FX/other.- Billing: Every request is charged. Re‑submitting the same track triggers a new credit deduction (no server‑side caching).
Authorizations
🔑 API Authentication
All endpoints require authentication using Bearer Token.
Get API Key
- Visit the API Key Management Page to obtain your API Key
Usage
Add to request headers:
Authorization: Bearer YOUR_API_KEY
⚠️ Note:
- Keep your API Key secure and do not share it with others
- If you suspect your API Key has been compromised, reset it immediately from the management page
Body
application/json
Response
Request successful
The response is of type object
.