How do I call the Suno Vox API endpoint?

Send an HTTP request to https://api.acedata.cloud/suno/vox with a Bearer token in the Authorization header. See the documentation for request parameters and response format.

What authentication does Suno Music Generation require?

All Ace Data Cloud APIs use Bearer token authentication. Get your API key from the platform dashboard at https://platform.acedata.cloud and include it as: Authorization: Bearer YOUR_TOKEN

How much does Suno Music Generation cost?

Suno Music Generation uses pay-as-you-go pricing with no monthly fees. Each API call costs credits based on the model and parameters used. Visit the service page for detailed pricing.

Ace Data Cloud

Q: What is Suno Vox API?

Suno vocal/instrumental stems API. Pass an audioid to asynchronously produce vocal-only and instrumental-only stem files for remixing and creative reuse.

Suno Vox API

POSThttps://api.acedata.cloud/suno/vox

Suno vocal/instrumental stems API. Pass an audio_id to asynchronously produce vocal-only and instrumental-only stem files for remixing and creative reuse.

Related Products

Suno - Ace Data Cloud

Suno music generation platform, directly interfaces with this API, high-speed and stable availability.

https://hub.acedata.cloud/suno

Request Headers

acceptstring

Specify the format of the response returned by the server. If not specified, the default format is `application/json`.

Please select

authorizationstring

Bearer token

Request Body

audio_idstringRequired parameter

The source audio ID used to extract human voice, which is the unique identifier of the Suno audio segment to be processed.

vocal_endnumber

End time point for vocal extraction (unit: seconds).

vocal_startnumber

The starting time point for vocal extraction (unit: seconds).

callback_urlstring

The callback address for receiving processing results. If not specified, the results will be returned directly in the response body.

asyncboolean

Whether to process in asynchronous mode. When set to `true`, the interface immediately returns `task_id`, without the need to provide `callback_url`, and then the result can be obtained by polling the corresponding task query interface; if `callback_url` is also provided, the result will be pushed to that callback address.

Please select

Response

Request successful, return OK.

Response Body

dataobject

Business data object returned by the API.

idstring

The unique ID of this result

statusstring

Processing status, for example, `complete` indicates that the processing is finished.

vocal_end_sinteger

The time point when the human voice ends, in seconds.

vocal_start_sinteger

The starting time point of the human voice, in seconds.

wave_responseobject

Audio waveform related data

waveform_aggregatesarray

List of waveform aggregation data at different zoom levels

Array of

dataarray

The result data returned from this request

Array of

mip_map_levelinteger

source_clip_idstring

Source audio segment ID

vocal_audio_urlstring

URL of the audio file of the separated voice

successboolean

A boolean flag indicating whether this request was successful.

task_idstring

The task ID for this request.

trace_idstring

The tracking ID for this request is used for debugging and link tracing.

Example

{
  "data": {
    "id": "24f0827e-5847-4011-b9b7-fc0b62032b65",
    "status": "complete",
    "vocal_end_s": 30,
    "vocal_start_s": 20,
    "wave_response": {
      "waveform_aggregates": [
        {
          "data": [
            [
              -4,
              4,
              -50,
              73,
              -2517,
              2887,
              294
            ],
            [
              -5,
              4,
              296
            ]
          ],
          "mip_map_level": 11
        },
        {
          "data": [
            [
              -19576,
              20406,
              -16717,
              16980,
              -18926,
              20807,
              -20029,
              20103,
              -16437,
              20899
            ],
            [
              -19578,
              20406,
              -16720,
              16980,
              -18825,
              20051,
              -20029,
              20103,
              -16453,
              20903
            ]
          ],
          "mip_map_level": 20
        }
      ]
    },
    "source_clip_id": "42599b24-fb14-4cd3-a444-e15ffde3661b",
    "vocal_audio_url": "https://cdn1.suno.ai/processed_24f0827e-5847-4011-b9b7-fc0b62032b65_vocals.m4a"
  },
  "success": true,
  "task_id": "9d5ce870-18e3-4c17-a1d9-7ef5a07918e9",
  "trace_id": "c31b50cd-0dbe-4e53-a7a5-83965dc5ad6b"
}

Allow Use General Balance

When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.

Shell

Python

JavaScript

Java

PHP

Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.