Suno API Task Info

Query the status and results of Suno music generation 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": "sunov5",
    "status": "running",
    "param": {
      "model": "suno/music-generate",
      "callback_url": null,
      "input": {
        "mode": "custom",
        "model": "v5",
        "instrumental": false,
        "title": "Midnight Addiction",
        "tags": "Western R&B, female vocal, dark, sensual",
        "lyrics": "[Verse 1] I still taste your words in the dark..."
      }
    },
    "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 music generation 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": "sunov5",
    "status": "running",
    "param": {
      "model": "suno/music-generate",
      "callback_url": null,
      "input": {
        "mode": "custom",
        "model": "v5",
        "instrumental": false,
        "title": "Midnight Addiction",
        "tags": "Western R&B, female vocal, dark, sensual",
        "lyrics": "[Verse 1] I still taste your words in the dark..."
      }
    },
    "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 music 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 adds a Suno-specific suno_data array in the task result when the task is successful.

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": "sunov5",
    "status": "running",
    "param": {
      "model": "suno/music-generate",
      "callback_url": null,
      "input": {
        "mode": "custom",
        "model": "v5",
        "instrumental": false,
        "title": "Midnight Addiction",
        "tags": "Western R&B, female vocal, dark, sensual",
        "lyrics": "[Verse 1] I still taste your words in the dark..."
      }
    },
    "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_urls

array<string>

Generated music media URLs. Returned only when status is success.

suno_data

array<SunoMusicItem>

Suno music items. Returned only when the task 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.

SunoMusicItem Object

suno_id

string

Suno Music ID

title

string

Music title

prompt

string

Lyrics or prompt used to generate the music.

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.suno_data` to get the Suno music items or result.media_url to get the result
`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 generation 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 Suno music items from result.suno_data
Download audio from each item’s suno_audio_url
Persist result metadata to your storage or database

Important: Generated media URLs(no suno original URL) 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

Suno Quickstart

Learn how to call Suno models

Generate Music

Create songs from text prompts with diverse styles.

Extend Music

Continue and expand existing music seamlessly.

Music Cover

Recreate songs in new styles or voices.

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

Persona Generate Vocal Separation Task Info

​API Endpoint

​Query Parameters

​Request Example

​Response Format

​SunoMusicItem Object

​Task Status Enum

​Get Task Result Best Practices

​Common Error Codes

​Rate Limits

​Related Resources

Suno Quickstart

Generate Music

Extend Music

Music Cover

Authorizations

Query Parameters

Response

API Endpoint

Query Parameters

Request Example

Response Format

SunoMusicItem Object

Task Status Enum

Get Task Result Best Practices

Common Error Codes

Rate Limits

Related Resources