generate_separation
PRE-FETCH (mandatory): resources/read kubeez://skills/media-upload AND kubeez://skills/billing-confirmation. Separation is billed per-minute of audio — preview cost first.
Split an audio track into vocals + instrumental stems (MVSEP BS Roformer). Scope: generate:media. Billing: per-minute of audio duration, measured by the server; the audio must be a Kubeez upload. CANONICAL FLOW: (1) if the user has a local file, call get_upload_url(model_id='mvsep-40') and send the link. (2) when they confirm upload, call get_upload_session(token) — it returns total_audio_seconds. (3) call estimate(model='mvsep-40', reference_audio_seconds=<total_audio_seconds>) to get the exact price. (4) tell the user the price and ask for confirmation. (5) ONLY THEN call this tool. Don't charge silently. Required: media_url — a public HTTPS URL of the uploaded audio. Async: returns {separation_id, task_id, status: 'pending'} immediately. Poll get_status(separation_id) until status is 'completed'. When completed, the response carries vocals_url + instrumental_url (permanent CDN). For a full workflow with preview + library, direct the user to kubeez.com/audio/separation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"media_url": "<media_url>"
},
"name": "generate_separation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media_url | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||