跳转到主要内容
POST
https://zx1.deepwl.net
/
suno
/
submit
/
{action}
Suno Music Generation
curl --request POST \
  --url https://zx1.deepwl.net/suno/submit/{action} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "prompt": "<string>",
  "tags": "<string>",
  "title": "<string>",
  "mv": "<string>",
  "continue_clip_id": "<string>"
}
'
{
  "code": "success",
  "message": "",
  "data": "task-suno-abc123"
}

Documentation Index

Fetch the complete documentation index at: https://doc.deepwl.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
Suno Music Generation

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.
  • Asynchronous processing mode; a task ID is returned after submission.
  • Supports single-task queries and batch queries.
  • Query results are wrapped with code, message, and data.

​
Route List

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

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
action
string
必填
The operation type. Common values are music, lyrics, and custom.

​
Body

​
prompt
string
必填
In music mode, this indicates the music description; in custom mode, it is usually the lyrics content directly.
​
tags
string
Style tags, separated by commas.
​
title
string
Song title.
​
mv
string
Model version, such as chirp-v3-5 or chirp-v4.
​
continue_clip_id
string
The clip ID used when continuing an existing music segment.

​
Request Example

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 Example

{
  "code": "success",
  "message": "",
  "data": "task-suno-abc123"
}

​
Use Cases

​
Automatic Composition

curl -X POST https://zx1.deepwl.net/suno/submit/music \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "An electronic pop track suitable for the opening of a product launch event",
    "tags": "electronic, upbeat"
  }'

​
Batch Query

curl -X POST https://zx1.deepwl.net/suno/fetch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["task-suno-abc123", "task-suno-def456"]
  }'