多元探索 API多元探索 API

Suno Music Generation

Use the `/suno/*` routes to submit asynchronous music tasks, and query lyrics or audio generation results.

POSThttps://zx1.deepwl.net/suno/submit/{action}
Request
curl -X POST https://zx1.deepwl.net/suno/submit/music \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '
{
  "prompt": "A catchy pop song about a summer night by the sea",
  "tags": "pop, summer, beach",
  "title": "Summer Night by the Sea",
  "mv": "chirp-v3-5"
}'
Response
{
  "code": "success",
  "message": "",
  "data": "task-suno-abc123"
}

The Suno routes use a separate asynchronous task protocol; both submission and querying do not go through /v1/audio/*. One entry point covers automatic composition, lyric generation, and custom-lyric music generation. Tasks are processed asynchronously — a task ID is returned after submission, and both single-task queries and batch queries are supported. Query results are wrapped with code, message, and data.

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Content-Typestring必填

Request content type, must be application/json.

Path Parameters

actionstring必填

The operation type. Common values are music, lyrics, and custom.

Request Body

promptstring必填

In music mode, this indicates the music description; in custom mode, it is usually the lyrics content directly.

tagsstring

Style tags, separated by commas.

titlestring

Song title.

mvstring

Model version, such as chirp-v3-5 or chirp-v4.

continue_clip_idstring

The clip ID used when continuing an existing music segment.

Route List

MethodPathDescription
POST/suno/submit/{action}Submit a music task
GET/suno/fetch/{id}Query a single task
POST/suno/fetchBatch query

Request Examples

Response Examples

Response Fields

codestring

Business status code. success indicates success; task_not_exist indicates the task does not exist.

messagestring

Status description message.

datastring | object

On successful submission, returns the task ID as a string; on successful query, returns a task detail object.

task_idstring

The task ID.

statusstring

Task status, e.g. SUCCESS.

progressstring

Task progress, e.g. 100%.

result_urlstring

Download URL of the generated result (audio).