ModelSell 文档
音频与其他Suno

Suno 生成歌词

POST
/suno/submit/lyrics

提交 Suno 歌词生成任务，成功后返回任务 ID，可通过任务查询接口读取歌词结果。

Authorization

bearerAuth
AuthorizationBearer <token>

使用 Authorization Bearer API Key 进行鉴权。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/suno/submit/lyrics" \  -H "Content-Type: application/json" \  -d '{    "prompt": "dance"  }'
{
  "code": "success",
  "msg": "成功",
  "data": "c47ec1cf-7e79-4e61-b9fb-2ca2ac36e57b",
  "message": "",
  "exec_time": 0,
  "ip": "string"
}
{
  "error": {
    "code": "string",
    "message": "string",
    "request_id": "string"
  }
}

生成音乐

提交 Suno 音乐生成任务，成功后返回 Suno 任务 ID，可通过 `/suno/fetch/{task_id}` 查询结果。生成音乐接口只提交任务，不直接返回最终音频；部分兼容接口会一次返回两个 Suno 任务 ID，客户端需要分别轮询或等待 Webhook 回调。 支持 Suno 灵感模式、固定自定义歌词模式、续写、纯音乐和音轨分离等参数组合。灵感模式通常传入 `gpt_description_prompt`、`tags`、`mv` 和 `title`；固定自定义歌词模式传入 `prompt` 歌词文本；音轨分离可传入 `task: gen_stem`、`continue_clip_id`、`stem_task` 等字段。`prompt` 在自定义模式最多 3000 字，灵感模式最多 200 字；`tags` 风格标签最多 120 字。传入知名艺术家名称可能无法生成。 `mv` 表示 Suno 模型版本，常用可选值包括 `chirp-v4`、`chirp-v3-5`、`chirp-bluejay`、`chirp-auk`、`chirp-fenix`。其中 `chirp-fenix` 对应 Suno 5.5 / 最新版；不传时通常按渠道默认模型处理。 已兼容 GoAmz 格式，GoAmz 接入地址前缀为 `{{BaseURL}}/suno/v1`，GoAmz 切换 v3.5 接入地址前缀为 `{{BaseURL}}/suno/v1/mv-3.5`。已兼容 SunoAPI 格式，SunoAPI 接入地址前缀为 `{{BaseURL}}/suno`。

查询音乐任务

根据 Suno 任务 ID 查询单个音乐或歌词任务详情，包括状态、进度、音频 URL、封面、歌词文本和元数据。