全部接口
mp4:生成 mp4 mv 视频
Timing:歌词、音频时间线
wav:获取 wav 格式文件
查询歌曲 (v1 版本)
查询歌词
查询歌曲
查询歌词 (v1 版本)
查询上传处理状态
批量获取任务
生成歌曲 (v1 版本)
声曲分离 (v1 版本)
拼接歌曲 (v1 版本)
生成歌词 (v1 版本)
Persona:创建歌手风格
生成歌曲(拼接歌曲)
生成歌词
生成歌曲(灵感模式)
生成歌曲(自定义模式)
生成歌曲(续写模式)
生成歌曲(上传歌曲二次创作)
生成歌曲(歌手风格)
生成歌曲(曲声分离)
生成歌曲(灵感模式) Copy
上传音乐通过 url
上传请求
初始化音频文件
报告上传完毕
模型信息
| 模型 ID | suno-act-tags | 供应商 | Suno |
|---|---|---|---|
| 输入模态 | 未注明 | 输出模态 | 未注明 |
| 分类 | 未注明 | 发布时间 | 1970-01-01 07:59:59 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| Persona:创建歌手风格 | Persona:创建歌手风格 | 本站 AI 中转站 | POST | /suno/persona/create/ |
POST /suno/persona/create/
### Persona:创建歌手风格
clip_id 需要系统内存在的,非 uploader
不能跨账号 所以可能账号下线用不了
返回体 关键的得到 id 为 fd213afd-ac1c-4822-9802-c1c0ea45e77b 设定为 persona_id 供下一步使用
{
"summary": "Persona:创建歌手风格",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### Persona:创建歌手风格\nclip_id 需要系统内存在的,非 uploader\n不能跨账号 所以可能账号下线用不了\n\n返回体 关键的得到 id 为 fd213afd-ac1c-4822-9802-c1c0ea45e77b 设定为 persona_id 供下一步使用",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Persona:创建歌手风格",
"$schema": "",
"required": [
"root_clip_id",
"name",
"description",
"clips",
"is_public"
],
"properties": {
"name": {
"type": "string"
},
"clips": {
"type": "array",
"items": {
"type": "string"
}
},
"is_public": {
"type": "boolean"
},
"description": {
"type": "string"
},
"root_clip_id": {
"type": "string"
}
},
"x-apifox-id": "294753975"
}
}
},
"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/persona/create/(Persona:创建歌手风格) | 2026-09-09 15:29:10 | |
| 价格分组:default(CNY 0.01/request) | 2026-09-09 15:29:10 | |
| 供应商令牌分组折扣资料 | 2026-09-09 15:29:10 |
常见问题:
| 标题 | 更新时间 | |
|---|---|---|
| Token 是什么?中文、英文与上下文窗口如何计算 | 2026-09-21 00:31:09 | |
| LLM API 费用如何计算?如何选择合适的模型 | 2026-09-21 01:16:03 | |
| Word-to-Token 转换与用量估算指南 | 2026-09-21 00:31:09 |
gemini-3.8-flash-thinking-medium
gemini-3.8-flash-thinking-high