全部接口
mp4:生成 mp4 mv 视频
Timing:歌词、音频时间线
wav:获取 wav 格式文件
查询歌曲 (v1 版本)
查询歌词
查询歌曲
查询歌词 (v1 版本)
查询上传处理状态
批量获取任务
生成歌曲 (v1 版本)
声曲分离 (v1 版本)
拼接歌曲 (v1 版本)
生成歌词 (v1 版本)
Persona:创建歌手风格
生成歌曲(拼接歌曲)
生成歌词
生成歌曲(灵感模式)
生成歌曲(自定义模式)
生成歌曲(续写模式)
生成歌曲(上传歌曲二次创作)
生成歌曲(歌手风格)
生成歌曲(曲声分离)
生成歌曲(灵感模式) Copy
上传音乐通过 url
上传请求
初始化音频文件
报告上传完毕
模型信息
| 模型 ID | suno_music | 供应商 | Suno |
|---|---|---|---|
| 输入模态 | 未注明 | 输出模态 | 未注明 |
| 分类 | 未注明 | 发布时间 | 未注明 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| 批量获取任务 | 批量获取任务 | 本站 AI 中转站 | POST | /suno/fetch |
POST /suno/fetch
{
"summary": "批量获取任务",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"01HYA5E4C7JK3Z54KZC15MT6MF",
"01HYA5E6591BRCC6W1VDFB5XSM",
"01HYA5E6J1YHDJZ55GGES1YCQA",
"01HYA5E6WS1W6XE3WSZ1QDQMS8",
"01HYA5E731PEJDJP7HS4YBQBG0",
"01HYA5E7FTPXEFSXWHT2PKBY79"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"status",
"metadata",
"audio_url",
"image_url",
"video_url",
"model_name",
"image_large_url",
"major_model_version"
],
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"metadata": {
"type": "object",
"required": [
"tags",
"prompt",
"duration",
"error_type",
"error_message",
"audio_prompt_id",
"gpt_description_prompt"
],
"properties": {
"tags": {
"type": "string"
},
"prompt": {
"type": "string"
},
"duration": {
"type": "null"
},
"error_type": {
"type": "null"
},
"error_message": {
"type": "null"
},
"audio_prompt_id": {
"type": "null"
},
"gpt_description_prompt": {
"type": "string"
}
}
},
"audio_url": {
"type": "string"
},
"image_url": {
"type": "string"
},
"video_url": {
"type": "string"
},
"model_name": {
"type": "string"
},
"image_large_url": {
"type": "string"
},
"major_model_version": {
"type": "string"
}
}
}
},
"action": {
"type": "string"
},
"status": {
"type": "string"
},
"task_id": {
"type": "string"
},
"progress": {
"type": "string"
},
"start_time": {
"type": "integer"
},
"fail_reason": {
"type": "string"
},
"finish_time": {
"type": "integer"
},
"notify_hook": {
"type": "string"
},
"submit_time": {
"type": "integer"
},
"01HYA5E4C7JK3Z54KZC15MT6MF": {
"x-tmp-pending-properties": true
},
"01HYA5E6591BRCC6W1VDFB5XSM": {
"x-tmp-pending-properties": true
},
"01HYA5E6J1YHDJZ55GGES1YCQA": {
"x-tmp-pending-properties": true
},
"01HYA5E6WS1W6XE3WSZ1QDQMS8": {
"x-tmp-pending-properties": true
},
"01HYA5E731PEJDJP7HS4YBQBG0": {
"x-tmp-pending-properties": true
},
"01HYA5E7FTPXEFSXWHT2PKBY79": {
"x-tmp-pending-properties": true
}
}
}
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "批量获取任务",
"$schema": "",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "task_id 列表"
},
"action": {
"type": "string",
"description": "操作：MUSIC、LYRICS"
}
},
"x-apifox-id": "175774564"
}
}
},
"required": true
}
}价格
| 价格组 | 渠道 | 计费项 | 价格 | 单位 |
|---|---|---|---|---|
| default | AI 中转站 | request | CNY 0.5 | 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/fetch（批量获取任务） | 2026-09-09 15:29:08 | |
| 价格分组：default（CNY 0.5/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 01:16:03 | |
| Word-to-Token 转换与用量估算指南 | 2026-09-21 00:31:09 |
gemini-3.8-flash-thinking-medium
gemini-3.8-flash-thinking-high
京公网安备11010802020088号