- 生成音乐（Deprecated）POST
- 生成音乐（V2）POST
- 任务查询POST
- 任务批量查询POST
- 生成歌词POST
- 优化提示词POST
- 上报参考音乐（阻塞）POST
- 上报参考音乐（异步）POST
- 获取上报结果（异步）POST
- 上报参考音乐（Deprecated）POST
- 查询剩余积分POST
- 查询服务状态POST
- 获取创建人设验证语句POST
- 创建歌手人设POST
- 获取歌手人设POST
- 重新激活歌手人设POST
- 查询歌手人设是否已失效POST
- 生成WAVPOST
- 获取WAVPOST
- 获取时间轴歌词POST
- 获取波形数据POST
- 生成MP4POST
- 获取MP4POST
- 开始分离POST
- 查询分离状态POST
- 生成MIDIPOST
- 获取MIDIPOST
- 临时tokenPOST
- 下载MP3POST
创建歌手人设
POST
https://suno.x-mi.cn/apiclouds/v1/suno/beginPersona
请求参数
Header 参数
Body 参数application/json
示例
//免核验人设入参
{
"url": "https://oss.suno.x-mi.cn/sample.mp3",
"name": "伤心太平洋",
"copyrightPersona": true
}
//旧模式入参
{
"url": "https://oss.suno.x-mi.cn/sample.mp3",
"name": "本人歌手",
"channelId": 108,
"phraseId": "phrase-xxx-xxx",
"verifyUrl": "https://oss.suno.x-mi.cn/verify.mp3"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://suno.x-mi.cn/apiclouds/v1/suno/beginPersona' \
--header 'x-apiid: 155358095076248003' \
--header 'x-token: sk-1E04222C99044971AEA4C850D95F6B0F' \
--header 'Content-Type: application/json' \
--data '//免核验人设入参
{
"url": "https://oss.suno.x-mi.cn/sample.mp3",
"name": "伤心太平洋",
"copyrightPersona": true
}
//旧模式入参
{
"url": "https://oss.suno.x-mi.cn/sample.mp3",
"name": "本人歌手",
"channelId": 108,
"phraseId": "phrase-xxx-xxx",
"verifyUrl": "https://oss.suno.x-mi.cn/verify.mp3"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 0,
"msg": "OK",
"data": "1fe776be-3397-48cb-805c-bdc6cd8ae4a2",
"success": true
}修改于 2026-09-17 09:02:51