Suno Vocal Separation Task Info

Query the status and results of Suno vocal separation tasks.

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Suno",
    "model_version": "suno-vocal-separation",
    "status": "running",
    "param": {
      "model": "suno/vocal-separatio",
      "callback_url": null,
      "input": {
        "task_id": "task_12345678",
        "suno_id": "suno_abc123",
        "mode": "vocal"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

GET

api

client

job

TaskInfo

Query the status and results of Suno vocal separation tasks.

curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/TaskInfo \
  --header 'x-api-key: <api-key>'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Suno",
    "model_version": "suno-vocal-separation",
    "status": "running",
    "param": {
      "model": "suno/vocal-separatio",
      "callback_url": null,
      "input": {
        "task_id": "task_12345678",
        "suno_id": "suno_abc123",
        "mode": "vocal"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

API Endpoint

GET https://api.crun.ai/api/v1/client/job/TaskInfo

This endpoint is used to query the execution status and retrieve the results of Suno vocal separation tasks created via the /api/v1/client/job/CreateTask API.
It shares the same endpoint, parameters, and task status enum as the common task query, but the task result does not include media_urls or suno_data. Instead, it returns a media_info object with audio stem URLs that vary by separation mode.

Query Parameters

task_id

string

required

The unique task identifier returned when you created the task.Example: task_12345678

Request Example

curl -X GET "https://api.crun.ai/api/v1/client/job/TaskInfo?task_id=task_12345678" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json"

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "d6956973-2f17-43d4-8514-af6cc3a2f55d",
    "provider": "Suno",
    "model_version": "suno-vocal-separation",
    "status": "running",
    "param": {
      "model": "suno/vocal-separatio",
      "callback_url": null,
      "input": {
        "task_id": "task_12345678",
        "suno_id": "suno_abc123",
        "mode": "vocal"
      }
    },
    "create_at": 1768900378,
    "result": null,
    "duration_s": null,
    "complete_at": null,
    "source": "api"
  }
}

Response Format

code

integer

Response status code. 200 indicates the request was successfully processed (the task was found and returned, regardless of execution result).

message

string

Response message. Typically "success".

data

object

The task data object containing all task information.

Show data properties

task_id

string

The unique identifier of the task.

provider

string

The model provider name.Example: Suno

model_version

string

A specific model version used when creating a task.

status

string

Current status of the task. See Task Status below for details.Possible values: pending, running, success, failed

param

object

Original parameters used to create the task.

Show param properties

model

string

Model identifier used when creating the task.

callback_url

string | null

Webhook callback URL configured for this task.

input

object

Model-specific input parameters. The structure varies depending on the selected model.

result

object | null

Task generation results. Valid value is returned only if the task status is success or failed; otherwise, null is returned.

Show result properties

code

integer

Task generation result status code. 200 indicates generation success. Non-200 values indicate generation failure.

message

string

Explanation of task success or failure.

media_info

object

Separated audio media URLs. Returned only when status is success.

create_at

integer

Unix timestamp (in seconds) when the task was created.

complete_at

integer | null

Unix timestamp (in seconds) when the task was completed. null if the task has not finished.

duration_s

integer | null

Task execution duration in seconds. Null if the task has not completed.

source

string

Source of task creation.

Media Info Object

origin_url

string

Original audio URL.

vocal_url

string

Main vocal audio URL.

instrumental_url

string

Instrumental part audio URL (vocal mode only).

backing_vocals_url

string

Backing vocals audio URL (instrumental mode only).

drums_url

string

Drums part audio URL (instrumental mode only).

bass_url

string

Bass part audio URL (instrumental mode only).

guitar_url

string

Guitar part audio URL (instrumental mode only).

keyboard_url

string

Keyboard part audio URL (instrumental mode only).

percussion_url

string

Percussion part audio URL (instrumental mode only).

strings_url

string

Strings part audio URL (instrumental mode only).

synth_url

string

Synthesizer part audio URL (instrumental mode only).

fx_url

string

Effects part audio URL (instrumental mode only).

brass_url

string

Brass part audio URL (instrumental mode only).

woodwinds_url

string

Woodwinds part audio URL (instrumental mode only).

Task Status Enum

Status	Description	Action
`pending`	Task is queued and waiting to be processed	Continue polling
`running`	Task is currently being processed	Continue polling
`success`	Task successfully completed	Access `result.media_info` to get stem URLs
`failed`	Task failed	Access result object to view error code and message.

Get Task Result Best Practices

Recommended Polling Intervals

Polling Interval: Use a polling interval between 15 and 30 seconds
Interval Dynamically: For long-running audio processing tasks, consider increasing the polling interval dynamically
Delayed Polling: Wait at least one polling interval before the first status check to reduce unnecessary requests
Maximum polling duration: Stop after 15-20 minutes and investigate

Excessive polling may result in rate limiting. Use callbacks for production applications.

Using Callbacks Instead of Polling

For production applications, we strongly recommend using the callback_url parameter when creating tasks:

No polling needed: Your server receives notifications automatically
Lower API costs: Eliminates continuous polling requests
Better performance: Immediate notifications when tasks complete
Reduced latency: No delay between completion and notification

Recommended method

Handling Completed Tasks

When status is success:

Retrieve the task result from the result field in the response
Extract stem URLs from result.media_info
Download audio files to your own storage
Persist result metadata to your storage or database

Important: Generated media URLs are typically permanently deleted after 14 days

Common Error Codes

Code	Description	Solution
`401`	Unauthorized - Invalid or missing API key	Check your API key
`404`	Task not found	Verify the task_id is correct
`429`	Exceeding the request rate limit	Reduce request frequency
`500`	Internal server error	Retry after a few minutes
`501`	Generation failed	View the `result` object to get the error code and message.

Rate Limits

Maximum query rate: 15 requests per second, per account limit
Recommended interval: 15-30 seconds between polls

Vocal Separation

Create a vocal separation task

Suno Quickstart

Learn how to call Suno models

Authorizations

x-api-key

string

header

required

All APIs require authentication via API Key.

Get API Key:

Visit API Key Management Page to get your API Key

Usage: Add to request header:

x-api-key: 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 in the management page

Query Parameters

task_id

string

required

Task ID used to retrieve task result.

Required string length: 36

Example:

"task_1234567"

Response

Task information retrieved successfully or task not found.

code

integer

required

Response status code

200: Success - Request has been processed successfully
401: Unauthorized - Authentication credentials are missing or invalid
402: Insufficient Credits - Account does not have enough credits to perform the operation
404: Not Found - The requested resource or endpoint does not exist
422: Validation Error - The request parameters failed validation checks
429: Rate Limited - Request limit has been exceeded for this resource
455: Service Unavailable - System is currently undergoing maintenance
500: Server Error - An unexpected error occurred while processing the request
501: Generation Failed - Content generation task failed
505: Feature Disabled - The requested feature is currently disabled

message

string

required

Response message

data

object

Task record and result information.

Show child attributes

Suno Task Info

​API Endpoint

​Query Parameters

​Request Example

​Response Format

​Media Info Object

​Task Status Enum

​Get Task Result Best Practices

​Common Error Codes

​Rate Limits

​Related Resources

Vocal Separation

Suno Quickstart

Authorizations

Query Parameters

Response

API Endpoint

Query Parameters

Request Example

Response Format

Media Info Object

Task Status Enum

Get Task Result Best Practices

Common Error Codes

Rate Limits

Related Resources