> ## Documentation Index > Fetch the complete documentation index at: https://docs.apistable.com/llms.txt > Use this file to discover all available pages before exploring further. # Vocal remover and stems > Use an audio URL for toolbox separation or an APIstable audio ID for native stems, then listen to and download individual parts. > Operations are enabled individually by server configuration. Disabled operations return 503 without a task. Music credit deduction is currently disabled. ## Using this operation Use an audio URL for toolbox separation or an APIstable audio ID for native stems, then listen to and download individual parts. * 1. Prepare the fields shown in the example below. Replace sample URLs and IDs with resources you can access. * 2. Set model to suno\_separate\_vocals and place the parameters inside input. Submit once and save the returned task\_id. * 3. Query the saved task or receive its callback. A processing result is not a reason to submit the operation again. * Iterate result.stems to access each part’s download\_url and expiry. Use the returned stem names and count. ## Create task Send model and input to the common task endpoint. callback\_url is an optional top-level public HTTPS address. All resource IDs are APIstable IDs owned by your account. Music credit deduction is currently disabled. ```json theme={null} { "model": "suno_separate_vocals", "input": { "type": "separate_vocal", "upload_url": "https://example.com/song.mp3" } } ``` ## Acceptance response HTTP 200 confirms acceptance, not completion. Query GET /api/v1/tasks/\{task\_id} until data.status is succeeded or failed. Read data.result only after success; a failed task has its error in data.message. ```json theme={null} { "code": 200, "msg": "success", "data": { "task_id": "YOUR_TASK_ID" } } ``` ## Fields: type = separate\_vocal | Field | Type | Required | Description and limits | | - | - | - | - | | type | string | Yes | separate\_vocal (2 tracks), split\_stem (4/6), or native split\_stem\_advanced. = separate\_vocal | | upload\_url | string | Yes | Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit. | | output\_format | string | No / conditional | Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction. values: mp3, wav, flac, ogg, m4a, aac; default: wav | ## Fields: type = split\_stem | Field | Type | Required | Description and limits | | - | - | - | - | | type | string | Yes | separate\_vocal (2 tracks), split\_stem (4/6), or native split\_stem\_advanced. = split\_stem | | upload\_url | string | Yes | Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit. | | stem\_mode | number | Yes | Toolbox separation: 4 or 6 stems. Vocal remover fixes this to 2 internally. values: 4, 6 | | output\_format | string | No / conditional | Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction. values: mp3, wav, flac, ogg, m4a, aac; default: wav | ## Fields: type = split\_stem\_advanced | Field | Type | Required | Description and limits | | - | - | - | - | | type | string | Yes | separate\_vocal (2 tracks), split\_stem (4/6), or native split\_stem\_advanced. = split\_stem\_advanced | | audio\_id | string | Yes | APIstable song ID belonging to your account. Cover/extend accept this ID only, without a source task\_id or external URL. maxLength: 200 | | stem\_name | string | No / conditional | Native extraction name. Only Piano is documented and enabled; omit for twelve-stem separation. maxLength: 100 | ## Inputs and limits The schema lists supported fields, types and basic limits. Also follow Important conditions: cross-field and source-resource checks are not fully represented in JSON Schema. Unknown parameters are rejected. URL fields accept public HTTPS URLs, never file objects. ```json theme={null} { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "separate_vocal", "description": "separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced." }, "upload_url": { "type": "string", "format": "uri", "description": "Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit." }, "output_format": { "default": "wav", "type": "string", "enum": [ "mp3", "wav", "flac", "ogg", "m4a", "aac" ], "description": "Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction." } }, "required": [ "type", "upload_url" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "split_stem", "description": "separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced." }, "upload_url": { "type": "string", "format": "uri", "description": "Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit." }, "stem_mode": { "anyOf": [ { "type": "number", "const": 4 }, { "type": "number", "const": 6 } ], "description": "Toolbox separation: 4 or 6 stems. Vocal remover fixes this to 2 internally." }, "output_format": { "default": "wav", "type": "string", "enum": [ "mp3", "wav", "flac", "ogg", "m4a", "aac" ], "description": "Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction." } }, "required": [ "type", "upload_url", "stem_mode" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "split_stem_advanced", "description": "separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced." }, "audio_id": { "type": "string", "minLength": 1, "maxLength": 200, "description": "APIstable song ID belonging to your account. Cover/extend accept this ID only, without a source task_id or external URL." }, "stem_name": { "type": "string", "minLength": 1, "maxLength": 100, "description": "Native extraction name. Only Piano is documented and enabled; omit for twelve-stem separation." } }, "required": [ "type", "audio_id" ], "additionalProperties": false } ] } ``` ## Important conditions * separate\_vocal and split\_stem use upload\_url with an audio limit of 100 MiB. separate\_vocal requests two stems; split\_stem requires stem\_mode=4 or 6. Choose the documented output\_format; default wav. * Native split\_stem\_advanced uses audio\_id, not upload\_url or output\_format. Omit stem\_name for twelve-stem separation, or pass Piano for the enabled single-stem extraction. Other names return 42201. Multiple groups may be returned; use the actual stems array rather than a fixed count. * Audio URL inputs must contain readable MP3/WAV/FLAC/OGG/M4A/AAC audio with positive duration; the limit is 100 MiB per file. URLs must be publicly accessible HTTPS on port 443, without embedded credentials or private-network addresses. Keep them accessible until the task finishes. * Uploaded files last 24 hours, generated files 14 days and task details 30 days. Reused files keep their original expiry. Valid Voice/Persona identity mappings are separate from task-log cleanup. Download files you need to retain. ## Result schema The creation response is \{code:200,msg:"success",data:\{task\_id}}. Poll GET /api/v1/tasks/\{task\_id}. On success, data.result is an object matching the schema below; it is otherwise null. input remains a JSON string. ```json theme={null} { "type": "object", "required": [ "stems" ], "properties": { "stems": { "type": "array", "items": { "type": "object", "properties": { "stem_name": { "type": [ "string", "null" ] }, "download_url": { "type": "string" }, "expires_at": { "type": "string" } } } } }, "additionalProperties": false } ``` ## Related workflows [Voice: all four steps](https://docs.apistable.com/en/suno-voice-workflow.md) [File uploads](https://docs.apistable.com/en/file-upload.md) [Callbacks](https://docs.apistable.com/en/webhooks.md) ## OpenAPI ````yaml openapi-suno-separate-vocals.json POST /api/v1/tasks/create_task openapi: 3.1.0 info: title: APIstable API version: 1.0.0-preview description: >- Public /api/v1 protocol. Valid API keys have the same account-scoped access. No client submission idempotency or max_credits. Enabled Suno operations use PayAPI and durable task processing. Media uses R2: uploads 24 hours, generated files 14 days, task logs 30 days. Music credit deduction is disabled. Unconfigured operations and LLM return 503. servers: - url: https://apistable.com description: APIstable API security: [] paths: /api/v1/tasks/create_task: post: summary: Vocal remover and stems description: >- Use an audio URL for toolbox separation or an APIstable audio ID for native stems, then listen to and download individual parts. operationId: suno_separate_vocals requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: false properties: model: type: string enum: - suno_separate_vocals example: suno_separate_vocals input: $schema: https://json-schema.org/draft/2020-12/schema oneOf: - type: object properties: type: type: string const: separate_vocal description: >- separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced. upload_url: type: string format: uri description: >- Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit. output_format: default: wav type: string enum: - mp3 - wav - flac - ogg - m4a - aac description: >- Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction. required: - type - upload_url additionalProperties: false - type: object properties: type: type: string const: split_stem description: >- separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced. upload_url: type: string format: uri description: >- Public HTTPS audio URL on port 443, without URL credentials. Use MP3/WAV/FLAC/OGG/M4A/AAC with a readable audio track. See the operation size limit. stem_mode: anyOf: - type: number const: 4 - type: number const: 6 description: >- Toolbox separation: 4 or 6 stems. Vocal remover fixes this to 2 internally. output_format: default: wav type: string enum: - mp3 - wav - flac - ogg - m4a - aac description: >- Toolbox output: mp3, wav (default), flac, ogg, m4a or aac. Not accepted for native stem extraction. required: - type - upload_url - stem_mode additionalProperties: false - type: object properties: type: type: string const: split_stem_advanced description: >- separate_vocal (2 tracks), split_stem (4/6), or native split_stem_advanced. audio_id: type: string minLength: 1 maxLength: 200 description: >- APIstable song ID belonging to your account. Cover/extend accept this ID only, without a source task_id or external URL. stem_name: type: string minLength: 1 maxLength: 100 description: >- Native extraction name. Only Piano is documented and enabled; omit for twelve-stem separation. required: - type - audio_id additionalProperties: false callback_url: type: string format: uri description: >- Optional public HTTPS endpoint for signed completion callbacks; no redirects or private IPs. example: model: suno_separate_vocals input: type: separate_vocal upload_url: https://example.com/song.mp3 responses: '200': description: Accepted task. Poll the common task endpoint or use callback_url. content: application/json: schema: type: object required: - code - msg - data additionalProperties: false properties: code: const: 200 msg: const: success data: type: object required: - task_id additionalProperties: false properties: task_id: type: string '400': description: >- 40001 invalid JSON, 40002 invalid input/callback, 40003 unsupported parameter. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Invalid or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: '40201: Insufficient credits (live acceptance).' content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: '40401: Unknown model or resource not found in this account.' content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: '40901: Resource belongs to a different provider account.' content: application/json: schema: $ref: '#/components/schemas/Error' '410': description: '41001: Source audio or temporary resource has expired.' content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: '41301: Request too large.' content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: '42201: Requested music combination is not enabled.' content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: '42901: Rate/concurrency limit (live acceptance).' content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: '50301: Service/provider unavailable. No live submission or charge.' content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: Error: type: object required: - code - msg - data properties: code: type: integer msg: type: string data: type: 'null' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Every valid key can submit and query its own account. Revoked keys are rejected. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.