功能与接口来源

可以输入歌曲描述自动创作，也可以提供自己的歌词、标题和风格生成歌曲；只需要歌词时使用歌词模型。音乐生成是异步任务，提交成功不等于音频已经生成。

本目录依据你正在使用的 SunoAPI 1.0.3 插件和 New API v1.0.0-rc.38 整理。插件源码明确标注 Unofficial plugin，上游是第三方开源项目 Suno-API/Suno-API。本目录的“原生”指该项目的请求格式，不表示 Suno 公司官方公开 API。

Suno 官方网站的创作功能、网页内部请求和青云TOP API 的公开入口是三件不同的事。不要把 Suno 网站内部地址直接替换为本站域名，也不需要提供 Suno 账号 Cookie 或官方账号凭据。本次未获得可以核实的 Suno 官方公开开发者 API 规范，因此不将网页内部接口列为本站调用方式。

先鉴权，再提交生成

所有示例使用基础地址 https://top.qingyuntop.ai，在请求头中直接填写：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

将 YOUR_API_KEY 替换为青云TOP API 控制台创建的 API Key。Bearer 后保留一个空格。GET 查询只需要 Authorization，不需要请求体。Key 应有相应模型的使用权限和足够额度。

调用过程是：带鉴权提交生成请求，保存返回的 ID；随后查询，成功后读取歌词或下载音频。查询步骤负责获取异步结果，不会再次生成歌曲。不要因等待时间长而重复提交。

选择一种格式

需求格式与入口下一步
最直接的歌曲生成SunoAPI：POST /suno/submit/music灵感模式
使用自己的歌词同一个 music 入口，使用 prompt、title、tags自定义歌词
只生成歌词文本POST /suno/submit/lyrics生成歌词
已采用 Responses 的应用POST /v1/responses，model 指定能力Responses 概览
查询 SunoAPI 任务GET /suno/fetch/{task_id} 或 POST /suno/fetch单个任务 / 批量任务
下载音频和封面GET /v1/tasks/{task_id}/artifacts下载说明

SunoAPI 格式在路径中选择 music 或 lyrics；Responses 格式在 model 中选择 suno_music 或 suno_lyrics。这两个模型名称不是歌曲版本号。歌曲版本通过 mv 传递，详见参数与模型版本。

当前范围

支持灵感歌曲、自定义歌词歌曲、纯音乐、歌词和任务查询。续写使用现有 music 入口，但有原歌曲访问和上游选择限制，先阅读续写说明。

当前插件未声明 Chat Completions、/suno/generate、音频上传、歌曲拼接、歌手风格、WAV 转换和歌词时间轴等旧入口。本次已从公开导航移除这些旧文档，不将通配路径中的任意 action 都视为可用。

示例中的 cURL 使用 Bash 引号与续行语法；Python 示例需要 requests；Node.js 示例使用内置 fetch，保存为 .mjs 后运行。代码可通过横向标签切换。

资料与核对范围

核对日期：2026-09-19。接口与示例经过源码及离线转换核对；具体歌曲版本是否可用由当前上游能力决定，不把网页产品版本或未经验证的字段视为可调用保证。