跳转到主要内容

​
Suno 音乐生成服务介绍

欢迎使用 Suno 音乐生成服务文档！ 本服务集成了 Suno AI，提供全面的音乐生成、编辑和音频处理工具套件。从创作原创曲目到训练您自己的定制模型，Suno 支持强大的端到端音乐工作流程。

​
支持的模型

模型描述
chirp-v55最新模型 — 最佳质量，推荐用于所有任务
chirp-v50高质量模型，上一代
chirp-45+高质量模型，性能优良
chirp-v45 / chirp-v45-lite质量与速度均衡
chirp-v40 / chirp-v35旧版模型
chirp-custom:<uuid>通过定制模型基于您自己的音频训练的定制模型

​
功能一览

音乐生成

通过统一的 /generate 端点，使用 15 种任务类型来创建、延伸、翻唱、混搭和采样音乐

歌词与音效

生成原创歌词、将两首歌曲的歌词进行混搭，或根据文本描述创建音效

声音角色

通过单任务两阶段语音验证，从您自己的录音中创建经过验证的声音角色

定制模型

基于 6 个以上音频文件训练个性化音乐模型，并用于生成

音频处理

重制曲目、调整速度、分离音轨、拼接片段，以及增强风格标签

导出与分析

导出为 MP4/WAV/MDI 格式，获取歌词时间线，分析节拍位置

Inspiration 灵感

两步播放列表流程 — 创建播放列表后使用 task=inspiration 生成

图片与视频

根据文本提示词独立生成图片与视频

片段编辑

对已有 clip 免费裁剪与淡入淡出

批量上传 Session

多个文件上传到同一 Suno 账号 — 适用于 Inspiration、Persona 等

​
如何使用 Suno

1

检查您任务所需的参数

使用 Generate Schema 端点获取您任务类型所需的精确必填/可选字段和请求示例。
2

创建任务

调用相应的端点（例如 Generate）并传入您的参数。您将收到一个 taskId。
3

轮询任务状态

使用 获取任务状态（GET /suno/v2/status?taskId=xxx）进行轮询，直到 status 为 success。
4

使用结果

任务结果包含您生成的音频片段数据。您可以将其用于后续操作，如导出、重制等。

​
快速示例

curl -X POST "https://api.mountsea.ai/suno/v2/generate" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "create",
    "model": "chirp-v50",
    "tags": "Pop, Happy, Upbeat",
    "prompt": "[Verse]\nHello world, here I come\n\n[Chorus]\nLa la la...",
    "title": "Summer Vibes"
  }'
不确定该传哪些参数？ 先调用 GET /suno/v2/generate/schema?task=your_task — 它会返回每种任务类型的必填字段、可选字段和完整的请求示例。试用 Generate Schema →

​
可用端点

​
核心生成

端点方法描述
/suno/v2/generatePOST统一生成端点 — 支持 15 种任务类型
/suno/v2/generate/schemaGET获取每种任务类型的参数模式和示例
/suno/v2/statusGET通过 taskId 查询任务状态

​
Inspiration（播放列表）

端点方法描述
/suno/v2/playlist/createPOST创建播放列表并绑定账号（同步）

​
图片、视频与片段编辑

端点方法描述
/suno/v2/image/generatePOST独立图片生成（异步）
/suno/v2/video/standalone/generatePOST独立视频生成（异步）
/suno/v2/audio/cropPOST裁剪 clip（异步，免费）
/suno/v2/audio/fadePOST淡入淡出（异步，免费）

​
歌词

端点方法描述
/suno/v2/lyricsPOST根据提示词生成歌词
/suno/v2/mashupLyricsPOST将两首歌曲的歌词进行混搭生成

​
音频处理

端点方法描述
/suno/v2/concatPOST拼接音频片段
/suno/v2/remasterPOST以增强质量重制音频
/suno/v2/adjustSpeedPOST调整播放速度
/suno/v2/upsampleTagsPOST创意增强风格标签

​
导出与分析

端点方法描述
/suno/v2/mp4POST将音频导出为 MP4 视频
/suno/v2/wavPOST将音频导出为 WAV
/suno/v2/mdiPOST下载 MDI 数据（来自 gen_stem_all）
/suno/v2/timingPOST获取歌词与音频时间线
/suno/v2/downbeatsPOST获取节拍位置

​
上传与角色

端点方法描述
/suno/v2/uploadPOST上传音频（单文件；账号可能不同）
/suno/v2/audio/upload/sessionPOST创建批量上传 Session（同步，同账号）
/suno/v2/audio/upload/session/itemPOSTSession 内上传单个文件（异步）
/suno/v2/personaPOST创建声音角色
/suno/v2/getVoxStemPOST提取人声音轨用于角色创建

​
Voice Persona（单任务、两阶段语音验证）

端点方法描述
/suno/v2/voicePersona/initPOST上传语音音频并获取验证短语（状态 → awaiting）
/suno/v2/voicePersona/completePOST上传验证录音并创建角色（使用相同 taskId）

​
Custom Model（三步模型训练）

端点方法描述
/suno/v2/customModel/preparePOST创建训练会话
/suno/v2/customModel/uploadPOST上传训练音频（至少 6 个文件）
/suno/v2/customModel/createPOST提交模型训练（100 积分）

​
浏览 API 文档

核心

  • Voice Persona 指南 — 完整工作流程指南（单个 taskId，两个阶段）
  • 初始化 — 上传语音并获取验证短语
  • 完成 — 上传验证录音并创建角色

​
生成任务类型

/suno/v2/generate 端点通过单一统一接口支持 15 种任务类型：
任务描述
create从零开始创建新音乐
extend从指定位置延伸已有音乐
upload_extend延伸已上传的外部音频
upload_cover翻唱已上传的外部音频
cover翻唱已有片段
use_styles_lyrics使用片段的风格搭配新歌词
replace_section替换已有音频的某个段落
add_instrumental为指定时间范围添加伴奏
add_vocals为指定时间范围添加人声
gen_stem_two分离为人声 + 伴奏
gen_stem_all分离为所有音轨
mashup将两首歌曲混搭
sample从已有片段中采样
inspiration基于真实播放列表生成（playlist_id 来自 /playlist/create）
sound生成音效
每种任务需要不同的参数。请使用 Generate Schema 获取每种任务类型的精确字段说明。