全部接口
mp4:生成 mp4 mv 视频
Timing:歌词、音频时间线
wav:获取 wav 格式文件
查询歌曲 (v1 版本)
查询歌词
查询歌曲
查询歌词 (v1 版本)
查询上传处理状态
批量获取任务
生成歌曲 (v1 版本)
声曲分离 (v1 版本)
拼接歌曲 (v1 版本)
生成歌词 (v1 版本)
Persona:创建歌手风格
生成歌曲(拼接歌曲)
生成歌词
生成歌曲(灵感模式)
生成歌曲(自定义模式)
生成歌曲(续写模式)
生成歌曲(上传歌曲二次创作)
生成歌曲(歌手风格)
生成歌曲(曲声分离)
生成歌曲(灵感模式) Copy
上传音乐通过 url
上传请求
初始化音频文件
报告上传完毕
模型信息
| 模型 ID | suno_lyrics | 供应商 | Suno |
|---|---|---|---|
| 输入模态 | 未注明 | 输出模态 | 未注明 |
| 分类 | 未注明 | 发布时间 | 未注明 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| 声曲分离 (v1 版本) | 声曲分离 (v1 版本) | 本站 AI 中转站 | POST | /suno/generate |
POST /suno/generate
### 声曲分离 (v1 版本)
将已生成的音乐进行声曲分离,分离出人声和伴奏两个音轨
{
"summary": "声曲分离 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### 声曲分离 (v1 版本)\n将已生成的音乐进行声曲分离,分离出人声和伴奏两个音轨",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "声曲分离 (v1 版本)",
"$schema": "",
"required": [
"task",
"generation_type",
"title",
"mv",
"continue_clip_id",
"stem_type_id",
"stem_type_group_name",
"stem_task"
],
"properties": {
"mv": {
"enum": [
"chirp-auk"
],
"type": "string",
"description": "模型版本,固定值为chirp-auk"
},
"task": {
"enum": [
"gen_stem"
],
"type": "string",
"description": "任务类型,固定值为gen_stem"
},
"title": {
"type": "string",
"description": "音乐标题"
},
"prompt": {
"type": "string",
"description": "提示词,通常为空字符串"
},
"stem_task": {
"enum": [
"two"
],
"type": "string",
"description": "分离任务类型,固定值为two"
},
"continue_at": {
"type": "null",
"description": "继续位置,通常为null"
},
"stem_type_id": {
"type": "integer",
"description": "分离类型ID,固定值为91"
},
"generation_type": {
"enum": [
"TEXT"
],
"type": "string",
"description": "生成类型,固定值为TEXT"
},
"continue_clip_id": {
"type": "string",
"description": "要进行分离的原始音乐clip_id"
},
"make_instrumental": {
"type": "boolean",
"description": "是否制作器乐版本"
},
"stem_type_group_name": {
"enum": [
"Two"
],
"type": "string",
"description": "分离类型组名,固定值为Two"
},
"continued_aligned_prompt": {
"type": "null",
"description": "对齐提示词,通常为null"
}
},
"x-apifox-id": "315376771"
}
}
},
"required": true
}
}价格
| 价格组 | 渠道 | 计费项 | 价格 | 单位 |
|---|---|---|---|---|
| default | AI 中转站 | request | CNY 0.01 | request |
服务级错误码参照(error_code):
| 错误码 | 说明 | |
|---|---|---|
| 221301 | 数据源超时 | |
| 221303 | 认证失败 认证失败,请稍后重试 认证失败,该卡当日连续多次认证不通过被限制校验,次日恢复 |
|
| 221306 | 参数错误 参数错误:姓名格式不正确 参数错误:手机号格式不正确 参数错误:身份证格式不正确 参数错误:银行卡号格式不正确 同一银行卡请求过于频繁 |
系统级错误码参照:
| 错误码 | 说明 | |
|---|---|---|
| 10001 | 错误的请求KEY | |
| 10002 | 该KEY无请求权限 | |
| 10003 | KEY过期 | |
| 10004 | 错误的OPENID | |
| 10005 | 应用未审核超时,请提交认证 | |
| 10007 | 未知的请求源 | |
| 10008 | 被禁止的IP | |
| 10009 | 被禁止的KEY | |
| 10011 | 当前IP请求超过限制 | |
| 10012 | 请求超过次数限制 | |
| 10013 | 测试KEY超过请求限制 | |
| 10014 | 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) | |
| 10020 | 接口维护 | |
| 10021 | 接口停用 |
错误码格式说明(示例:200201):
| 2 | 002 | 01 | |
|---|---|---|---|
| 服务级错误(1为系统级错误) | 服务模块代码(即数据ID) | 具体错误代码 |
使用文档下载
| 附件标题/下载链接 | 更新时间 | |
|---|---|---|
| 接口资料:POST /suno/generate(声曲分离 (v1 版本)) | 2026-09-09 15:29:08 | |
| 价格分组:default(CNY 0.01/request) | 2026-09-09 15:29:08 | |
| 供应商令牌分组折扣资料 | 2026-09-09 15:29:08 |
常见问题:
| 标题 | 更新时间 | |
|---|---|---|
| Token 是什么?中文、英文与上下文窗口如何计算 | 2026-09-21 00:31:09 | |
| LLM API 费用如何计算?如何选择合适的模型 | 2026-09-21 00:31:33 | |
| Word-to-Token 转换与用量估算指南 | 2026-09-21 00:31:09 |
gemini-3.8-flash-thinking-medium
gemini-3.8-flash-thinking-high