Skip to main content
POST
https://zx1.deepwl.net
/
suno
/
submit
/
{action}
Suno 音乐生成
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://docs.deepwl.cn/llms.txt

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

​
Suno 音乐生成

Suno 路由采用独立的异步任务协议，提交与查询都不走 /v1/audio/*。
  • 一个入口覆盖自动作曲、歌词生成和自定义歌词生曲。
  • 异步处理模式，提交后返回任务 ID。
  • 支持单任务查询和批量查询。
  • 查询结果使用 code、message、data 包装。

​
路由清单

MethodPath说明
POST/suno/submit/{action}提交音乐任务
GET/suno/fetch/{id}查询单任务
POST/suno/fetch批量查询

​
认证

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
action
string
required
操作类型。常见值为 music、lyrics、custom。

​
Body

​
prompt
string
required
music 模式下表示音乐描述；custom 模式下通常直接传歌词内容。
​
tags
string
风格标签，逗号分隔。
​
title
string
歌曲标题。
​
mv
string
模型版本，例如 chirp-v3-5 或 chirp-v4。
​
continue_clip_id
string
续写已有音乐片段时使用的 clip ID。

​
请求示例

curl -X POST zx1.deepwl.net/suno/submit/music \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一首关于夏夜海边的轻快流行歌曲",
    "tags": "pop, summer, beach",
    "title": "海边的夏夜",
    "mv": "chirp-v3-5"
  }'

​
响应示例

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

​
使用场景

​
自动作曲

curl -X POST zx1.deepwl.net/suno/submit/music \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一首适合产品发布会开场的电子流行乐",
    "tags": "electronic, upbeat"
  }'

​
批量查询

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

​
相关接口