全部接口
mp4:生成 mp4 mv 视频
Timing:歌词、音频时间线
wav:获取 wav 格式文件
查询歌曲 (v1 版本)
查询歌词
查询歌曲
查询歌词 (v1 版本)
查询上传处理状态
批量获取任务
生成歌曲 (v1 版本)
声曲分离 (v1 版本)
拼接歌曲 (v1 版本)
生成歌词 (v1 版本)
Persona:创建歌手风格
生成歌曲(拼接歌曲)
生成歌词
生成歌曲(灵感模式)
生成歌曲(自定义模式)
生成歌曲(续写模式)
生成歌曲(上传歌曲二次创作)
生成歌曲(歌手风格)
生成歌曲(曲声分离)
生成歌曲(灵感模式) Copy
上传音乐通过 url
上传请求
初始化音频文件
报告上传完毕
模型信息
| 模型 ID | suno_upload | 供应商 | Suno |
|---|---|---|---|
| 输入模态 | 未注明 | 输出模态 | 未注明 |
| 分类 | 未注明 | 发布时间 | 1970-01-01 07:59:59 |
调用接口
| 分组 | 接口 | 渠道 | 方法 | 路径 |
|---|---|---|---|---|
| 全部接口 | mp4:生成 mp4 mv 视频 | 本站 AI 中转站 | GET | /suno/act/mp4/{clip_id} |
| 全部接口 | Timing:歌词、音频时间线 | 本站 AI 中转站 | GET | /suno/act/timing/{clip_id} |
| 全部接口 | wav:获取 wav 格式文件 | 本站 AI 中转站 | GET | /suno/act/wav/{clip_id} |
| 全部接口 | 查询歌曲 (v1 版本) | 本站 AI 中转站 | GET | /suno/feed/{songid1},{songid2} |
| 全部接口 | 查询歌词 | 本站 AI 中转站 | GET | /suno/fetch/{task_id} |
| 全部接口 | 查询歌曲 | 本站 AI 中转站 | GET | /suno/fetch/{task_id} |
| 全部接口 | 查询歌词 (v1 版本) | 本站 AI 中转站 | GET | /suno/lyrics/{task_id} |
| 全部接口 | 查询上传处理状态 | 本站 AI 中转站 | GET | /sunoi/uploads/audio/{id} |
| 全部接口 | 批量获取任务 | 本站 AI 中转站 | POST | /suno/fetch |
| 全部接口 | 生成歌曲 (v1 版本) | 本站 AI 中转站 | POST | /suno/generate |
| 全部接口 | 声曲分离 (v1 版本) | 本站 AI 中转站 | POST | /suno/generate |
| 全部接口 | 拼接歌曲 (v1 版本) | 本站 AI 中转站 | POST | /suno/generate/concat |
| 全部接口 | 生成歌词 (v1 版本) | 本站 AI 中转站 | POST | /suno/generate/lyrics/ |
| 全部接口 | Persona:创建歌手风格 | 本站 AI 中转站 | POST | /suno/persona/create/ |
| 全部接口 | 生成歌曲(拼接歌曲) | 本站 AI 中转站 | POST | /suno/submit/concat |
| 全部接口 | 生成歌词 | 本站 AI 中转站 | POST | /suno/submit/lyrics |
| 全部接口 | 生成歌曲(灵感模式) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(自定义模式) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(续写模式) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(上传歌曲二次创作) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(歌手风格) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(曲声分离) | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 生成歌曲(灵感模式) Copy | 本站 AI 中转站 | POST | /suno/submit/music |
| 全部接口 | 上传音乐通过 url | 本站 AI 中转站 | POST | /suno/uploads/audio-url |
| 全部接口 | 上传请求 | 本站 AI 中转站 | POST | /sunoi/uploads/audio |
| 全部接口 | 初始化音频文件 | 本站 AI 中转站 | POST | /sunoi/uploads/audio/{id}/initialize-clip |
| 全部接口 | 报告上传完毕 | 本站 AI 中转站 | POST | /sunoi/uploads/audio/{id}/upload-finish |
GET /suno/act/mp4/{clip_id}
{
"summary": "mp4:生成 mp4 mv 视频",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "clip_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "mp4:生成 mp4 mv 视频",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "294760478"
}
}
},
"required": true
}
}GET /suno/act/timing/{clip_id}
{
"summary": "Timing:歌词、音频时间线",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "clip_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "Timing:歌词、音频时间线",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "294760071"
}
}
},
"required": true
}
}GET /suno/act/wav/{clip_id}
{
"summary": "wav:获取 wav 格式文件",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "clip_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "wav:获取 wav 格式文件",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "294760335"
}
}
},
"required": true
}
}GET /suno/feed/{songid1},{songid2}
{
"summary": "查询歌曲 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "songid1",
"schema": {
"type": "string"
},
"required": true,
"description": ""
},
{
"in": "path",
"name": "songid2",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "查询歌曲 (v1 版本)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "290935683"
}
}
},
"required": true
}
}GET /suno/fetch/{task_id}
{
"summary": "查询歌词",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "object",
"required": [
"task_id",
"notify_hook",
"action",
"status",
"fail_reason",
"submit_time",
"start_time",
"finish_time",
"progress",
"data"
],
"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": [
"integer",
"number"
]
},
"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"
}
}
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string",
"description": "任务ID"
},
"required": true,
"description": "任务ID"
}
],
"description": ""
}GET /suno/fetch/{task_id}
{
"summary": "查询歌曲",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "object",
"required": [
"task_id",
"notify_hook",
"action",
"status",
"fail_reason",
"submit_time",
"start_time",
"finish_time",
"progress",
"data"
],
"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": [
"integer",
"number"
]
},
"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"
}
}
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string",
"description": "任务ID"
},
"required": true,
"description": "任务ID"
}
],
"description": ""
}GET /suno/lyrics/{task_id}
{
"summary": "查询歌词 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "task_id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "查询歌词 (v1 版本)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "290939762"
}
}
},
"required": true
}
}GET /sunoi/uploads/audio/{id}
{
"summary": "查询上传处理状态",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "查询上传处理状态",
"$schema": "",
"required": [
"upload_type",
"upload_filename"
],
"properties": {
"upload_type": {
"type": "string"
},
"upload_filename": {
"type": "string"
}
},
"x-apifox-id": "294752734"
}
}
},
"required": true
}
}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
}
}POST /suno/generate
{
"summary": "生成歌曲 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲 (v1 版本)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "294772799"
}
}
},
"required": true
}
}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
}
}POST /suno/generate/concat
{
"summary": "拼接歌曲 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "拼接歌曲 (v1 版本)",
"$schema": "",
"required": [
"clip_id",
"is_infill"
],
"properties": {
"clip_id": {
"type": "string"
},
"is_infill": {
"type": "boolean"
}
},
"x-apifox-id": "290952475"
}
}
},
"required": true
}
}POST /suno/generate/lyrics/
{
"summary": "生成歌词 (v1 版本)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌词 (v1 版本)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
}
},
"x-apifox-id": "290938780"
}
}
},
"required": true
}
}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
}
}POST /suno/submit/concat
### 生成歌曲(拼接歌曲)
1. 先生成音乐（2首
2. 续写又得到音乐（2首
3. 把要续写的音乐id 给放这，拼接得到完整音乐
{
"summary": "生成歌曲(拼接歌曲)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "string",
"description": "task_id"
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### 生成歌曲(拼接歌曲)\n1. 先生成音乐（2首\n2. 续写又得到音乐（2首\n3. 把要续写的音乐id 给放这，拼接得到完整音乐",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(拼接歌曲)",
"$schema": "",
"required": [
"clip_id"
],
"properties": {
"clip_id": {
"type": "string",
"description": "extend 后的 歌曲ID"
},
"is_infill": {
"type": "boolean"
}
},
"x-apifox-id": "208365078"
}
}
},
"required": true
}
}POST /suno/submit/lyrics
{
"summary": "生成歌词",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "string",
"description": "task_id"
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌词",
"$schema": "",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"description": "歌词提示词"
},
"notify_hook": {
"type": "string",
"description": "回调地址"
}
},
"x-apifox-id": "175774406"
}
}
},
"required": true
}
}POST /suno/submit/music
{
"summary": "生成歌曲(灵感模式)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(灵感模式)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "290934291"
}
}
},
"required": true
}
}POST /suno/submit/music
{
"summary": "生成歌曲(自定义模式)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(自定义模式)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "290935144"
}
}
},
"required": true
}
}POST /suno/submit/music
{
"summary": "生成歌曲(续写模式)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(续写模式)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "290942843"
}
}
},
"required": true
}
}POST /suno/submit/music
{
"summary": "生成歌曲(上传歌曲二次创作)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(上传歌曲二次创作)",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string",
"description": "upload_extend"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string",
"description": "上传的初始化歌曲id"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "294753410"
}
}
},
"required": true
}
}POST /suno/submit/music
### 生成歌曲(歌手风格)
# 接入步骤：
### A.生成音乐
可以通过场生成歌曲接口生成后，获取其中的一首歌的 clip_id 值为 54834687-5e79-4f08-8e14-cf188f15b598
### B.新建 Persona
clip_id 需要系统内存在的,非 uploader
不能跨账号 所以可能账号下线用不了
### C.使用 persona_id 创作
注意 mv 为 chirp-v3-5-tau 或者 chirp-v4-tau
task 为 artist_consistency
persona_id 为 B 步骤得到的
artist_clip_id 就是 A 步骤中的 clip_id
可跨账号
{
"summary": "生成歌曲(歌手风格)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### 生成歌曲(歌手风格)\n# 接入步骤：\n### A.生成音乐\n可以通过场生成歌曲接口生成后，获取其中的一首歌的 clip_id 值为 54834687-5e79-4f08-8e14-cf188f15b598\n\n### B.新建 Persona\nclip_id 需要系统内存在的,非 uploader\n不能跨账号 所以可能账号下线用不了\n\n### C.使用 persona_id 创作\n注意 mv 为 chirp-v3-5-tau 或者 chirp-v4-tau\ntask 为 artist_consistency\npersona_id 为 B 步骤得到的\nartist_clip_id 就是 A 步骤中的 clip_id\n可跨账号",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(歌手风格)",
"$schema": "",
"required": [
"prompt",
"generation_type",
"tags",
"negative_tags",
"mv",
"title",
"task",
"persona_id",
"artist_clip_id"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"persona_id": {
"type": "string"
},
"negative_tags": {
"type": "string"
},
"artist_clip_id": {
"type": "string"
},
"generation_type": {
"type": "string"
}
},
"x-apifox-id": "294754915"
}
}
},
"required": true
}
}POST /suno/submit/music
### 生成歌曲(曲声分离)
请求体
注意 mv为 chirp-auk
task 为 gen_stem
stem_task 为 two
stem_type_group_name 为 Two
continue_clip_id 就是 A 步骤中的 clip_id
可跨账号
计费:一次生成费用
{
"summary": "生成歌曲(曲声分离)",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "### 生成歌曲(曲声分离)\n请求体\n\n注意 mv为 chirp-auk\ntask 为 gen_stem\nstem_task 为 two\nstem_type_group_name 为 Two\ncontinue_clip_id 就是 A 步骤中的 clip_id\n可跨账号\n计费:一次生成费用",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(曲声分离)",
"$schema": "",
"required": [
"task",
"generation_type",
"title",
"mv",
"prompt",
"make_instrumental",
"continue_clip_id",
"continued_aligned_prompt",
"continue_at",
"stem_type_id",
"stem_type_group_name",
"stem_task"
],
"properties": {
"mv": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"stem_task": {
"type": "string"
},
"continue_at": {
"type": "null"
},
"stem_type_id": {
"type": "integer"
},
"generation_type": {
"type": "string"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
},
"stem_type_group_name": {
"type": "string"
},
"continued_aligned_prompt": {
"type": "null"
}
},
"x-apifox-id": "318769173"
}
}
},
"required": true
}
}POST /suno/submit/music
{
"summary": "生成歌曲(灵感模式) Copy",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "生成歌曲(灵感模式) Copy",
"$schema": "",
"required": [
"prompt",
"mv",
"title",
"tags",
"continue_at",
"continue_clip_id",
"task",
"make_instrumental"
],
"properties": {
"mv": {
"type": "string"
},
"tags": {
"type": "string"
},
"task": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": "string"
},
"continue_at": {
"type": "integer"
},
"continue_clip_id": {
"type": "string"
},
"make_instrumental": {
"type": "boolean"
}
},
"x-apifox-id": "323777831"
}
}
},
"required": true
}
}POST /suno/uploads/audio-url
{
"summary": "上传音乐通过 url",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "string"
},
"data": {
"type": "string",
"description": "task_id"
},
"message": {
"type": "string"
}
}
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "上传音乐通过 url",
"$schema": "",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "上传的音乐"
}
},
"x-apifox-id": "208365072"
}
}
},
"required": true
}
}POST /sunoi/uploads/audio
{
"summary": "上传请求",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "上传请求",
"$schema": "",
"required": [
"extension"
],
"properties": {
"extension": {
"type": "string"
}
},
"x-apifox-id": "294748271"
}
}
},
"required": true
}
}POST /sunoi/uploads/audio/{id}/initialize-clip
{
"summary": "初始化音频文件",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "初始化音频文件",
"$schema": "",
"properties": [],
"x-apifox-id": "294753238"
}
}
},
"required": true
}
}POST /sunoi/uploads/audio/{id}/upload-finish
{
"summary": "报告上传完毕",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": []
}
}
},
"description": "成功"
}
},
"parameters": [
{
"in": "path",
"name": "id",
"schema": {
"type": "string"
},
"required": true,
"description": ""
}
],
"description": "",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"title": "报告上传完毕",
"$schema": "",
"required": [
"upload_type",
"upload_filename"
],
"properties": {
"upload_type": {
"type": "string"
},
"upload_filename": {
"type": "string"
}
},
"x-apifox-id": "294752192"
}
}
},
"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) | 具体错误代码 |
使用文档下载
常见问题：
| 标题 | 更新时间 | |
|---|---|---|
| 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号