SunoAPI · 提交任务

POST

/suno/submit/{action}

SunoAPI，插件 sunoapi 1.1.0。源码：plugins/tasks/sunoapi/plugin.js。

路径 action 取 MUSIC 或 LYRICS，大小写均可。LYRICS 需要非空 prompt。MUSIC 的 mv 默认 chirp-v3-0，make_instrumental 默认 false。提交成功时 data 是网关任务 ID 字符串。

使用网关 Bearer 令牌。查询返回当前用户的任务快照，上游状态由后台轮询更新。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

创建成功，按当前插件返回 JSON。

Bodyapplication/json

🟠400

🟠401

🟠404

🟠415

⚪default

请求示例

Shell

JavaScript

Java

Swift

cURL

示例 1示例 2

curl --location '/suno/submit/MUSIC' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "gpt_description_prompt": "一首关于夏日海边的轻快歌曲",
    "make_instrumental": false
}'

响应示例

200 - 提交确认或等待中

示例使用固定任务数据，通过当前插件的响应函数生成。

{
  "code": "success",
  "message": "accepted",
  "data": "task_example"
}

修改于 2026-10-17 05:04:55

Hailuo Video · 查询任务

SunoAPI · 批量查询