一步API中文文档
  1. 接口
一步API中文文档
  • 01_人工客服
  • 02_购买地址
  • 03_base_url说明
  • 04_API key的获取和使用
  • 05_支持的模型与在线查询
  • 06_API Key余额查询
  • 07_常用工具配置教程
    • 01_Chatbox多端一键配置Claude/GPT/DeepSeek等主流模型
    • 02_JetBrains 全家桶(idea、PyCharm、WebStorm)配置教程
    • 03_Cursor配置
    • 04_Trae AI配置
    • 05_AingDesk配置(更新中)
    • 06_vscode配置(更新中)
  • 08_示例代码
    • python
      • 01_OpenAI-Python示例代码
      • 02_Claude-Python示例代码
      • 03_OpenAI-image-Python示例代码
      • 04_Gemini-Python示例代码
      • 05_Python分析文件代码示例
      • 06_Python其他示例
    • Java
      • 01_OpenAI-Java示例代码
      • 02_Claude-Java示例代码
  • 聊天接口(Chat)
    • 图片识别接口
    • 聊天接口(通用)
  • 向量生成(Embeddings)
    • 创建嵌入
  • 文生图片(Images)
    • DALL·E
  • 音频(Audio)
    • TTS文本转语音
  • 更新中
    • API的介绍及使用教程点击内涵链接
    • 常用教程合集
    • Anthropic Claude接口
    • Claude账号登录教程
  • 接口
    • Anthropic 对话格式(Messages)
    • Cohere 重排序格式(Rerank)
    • Deepseek reasoning 对话格式(类Chat Completions)
    • Jina AI 重排序格式(Rerank)
    • Midjourney 图像格式(Midjourney Proxy/Midjourney Proxy Plus)
    • OpenAI 音频格式
    • OpenAI 对话格式(Chat Completions)
    • OpenAI 嵌入格式(Embeddings)
    • OpenAI 图像格式(Image)
    • OpenAI 实时对话接口
    • OpenAI 响应格式(Responses)
    • Suno 音乐格式(Music)
    • Xinference 重排序格式(Rerank)
  1. 接口

Suno 音乐格式(Music)

Suno 音乐格式(Music)#

!!! note "请你注意"
该接口 非Suno官方的接口,而是基于作者 柏拉图 的开源项目 Suno-API 实现的Suno代理接口。
这里非常感谢作者的贡献,让我们可以方便使用Suno的强大功能,如果有时间,请给作者一个Star。

📝 简介#

Suno Music API 提供了一系列音乐生成和处理的功能,包括:
根据提示生成歌曲(灵感模式、自定义模式)
续写已有歌曲
拼接多个音频片段
生成歌词
上传音频
通过 API 可以方便地将 AI 音乐生成能力集成到你的应用中。

💡 请求示例#

生成歌曲 ✅#

响应示例:
{
  "code":"success",
  "message":"",
  "data":"736a6f88-bd29-4b1e-b110-37132a5325ac"
}

生成歌词 ✅#

响应示例:
{
  "code":"success",
  "message":"",
  "data":"736a6f88-bd29-4b1e-b110-37132a5325ac" 
}

上传音频 ❌#

响应示例:
{
  "code":"success",
  "message":"",
  "data":"736a6f88-bd29-4b1e-b110-37132a5325ac"
}  

歌曲拼接 ❌#

响应示例:
{
  "code":"success", 
  "message":"",
  "data":"736a6f88-bd29-4b1e-b110-37132a5325ac"  
}

查询任务状态 ✅#

批量查询#

响应示例:
{
  "code":"success",
  "message":"", 
  "data":[
    {
      "task_id":"346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
      "notify_hook":"",
      "action":"MUSIC", 
      "status":"IN_PROGRESS",
      "fail_reason":"",
      "submit_time":1716191749, 
      "start_time":1716191786,
      "finish_time":0,
      "progress":"0%",
      "data":[
        {
          "id":"e9893d04-6a63-4007-8473-64b706eca4d1",
          "title":"Electric Dance Party",
          "status":"streaming",
          "metadata":{
            "tags":"club banger high-energy edm",
            "prompt":"略",
            "duration":null,
            "error_type":null,
            "error_message":null, 
            "audio_prompt_id":null,
            "gpt_description_prompt":"miku dance"
          },
          "audio_url":"https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
          "image_url":"https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "video_url":"",
          "model_name":"chirp-v3", 
          "image_large_url":"https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png", 
          "major_model_version":"v3"
        }
      ]
    } 
  ] 
}

单个查询#

响应示例:
{
  "code":"success",
  "message":"",
  "data":{
    "task_id":"f4a94d75-087b-4bb1-bd45-53ba293faf96",
    "notify_hook":"", 
    "action":"LYRICS",
    "status":"SUCCESS",
    "fail_reason":"",
    "submit_time":1716192124, 
    "start_time":1716192124, 
    "finish_time":1716192124,
    "progress":"100%", 
    "data":{
      "id":"f4a94d75-087b-4bb1-bd45-53ba293faf96",
      "text":"略", 
      "title":"Electric Fantasy",
      "status":"complete"  
    }
  }
}

📮 请求#

所有请求都需在请求头中包含认证信息:
Authorization: Bearer $NEWAPI_API_KEY

端点#

生成歌曲#

POST /suno/submit/music  
生成新的歌曲,支持灵感模式、自定义模式、续写。

生成歌词#

POST /suno/submit/lyrics
根据提示生成歌词。

上传音频#

POST /suno/uploads/audio-url
上传音频文件。

歌曲拼接#

POST /suno/submit/concat
将多个音频片段拼接为一首完整的歌曲。

批量查询任务状态#

POST /suno/fetch  
批量获取多个任务的状态和结果。

查询单个任务状态#

GET /suno/fetch/{{task_id}}
查询单个任务的状态和结果。

请求体参数#

生成歌曲#

prompt#
类型:String
必需:灵感模式无需,自定义模式必需
说明:歌词内容,在自定义模式下需提供
mv#
类型:String
必需:否
说明:模型版本,可选值:chirp-v3-0、chirp-v3-5,默认为 chirp-v3-0
title#
类型:String
必需:灵感模式无需,自定义模式必需
说明:歌曲标题,在自定义模式下需提供
tags#
类型:String
必需:灵感模式无需,自定义模式必需
说明:歌曲风格标签,使用逗号分隔,在自定义模式下需提供
make_instrumental#
类型:Boolean
必需:否
说明:是否生成纯音乐,true 为生成纯音乐
task_id#
类型:String
必需:续写时必需
说明:要续写的歌曲的任务 ID
continue_at#
类型:Float
必需:续写时必需
说明:从歌曲的第几秒开始续写
continue_clip_id#
类型:String
必需:续写时必需
说明:要续写的歌曲的 clip ID
gpt_description_prompt#
类型:String
必需:灵感模式必需,其他模式无需
说明:灵感来源的文字描述
notify_hook#
类型:String
必需:否
说明:歌曲生成完成的回调通知地址

生成歌词#

prompt#
类型:String
必需:是
说明:歌词的主题或关键词
notify_hook#
类型:String
必需:否
说明:歌词生成完成的回调通知地址

上传音频#

url#
类型:String
必需:是
说明:要上传的音频文件的 URL 地址

歌曲拼接#

clip_id#
类型:String
必需:是
说明:要拼接的歌曲片段的 ID
is_infill#
类型:Boolean
必需:否
说明:是否为填充模式

任务查询#

ids#
类型:String[]
必需:是
说明:要查询的任务 ID 列表
action#
类型:String
必需:否
说明:任务类型,可选值:MUSIC、LYRICS

📥 响应#

所有接口均返回统一的 JSON 格式响应:
{
  "code":"success",
  "message":"",
  "data":"{{RESULT}}" 
}

成功响应#

基础响应字段#

code#
类型:String
说明:请求状态,success 为成功
message#
类型:String
说明:请求失败时的错误信息
data#
类型:根据不同接口而异
说明:请求成功时的返回数据
生成歌曲、歌词、上传音频、歌曲拼接接口:返回任务 ID 字符串
任务查询接口:返回任务对象或任务对象数组

任务相关对象#

任务对象#
task_id#
类型:String
说明:任务 ID
notify_hook#
类型:String
说明:任务完成后的回调通知地址
action#
类型:String
说明:任务类型,可选值:MUSIC、LYRICS
status#
类型:String
说明:任务状态,可选值:IN_PROGRESS、SUCCESS、FAIL
fail_reason#
类型:String
说明:任务失败原因
submit_time#
类型:Integer
说明:任务提交时间戳
start_time#
类型:Integer
说明:任务开始时间戳
finish_time#
类型:Integer
说明:任务结束时间戳
progress#
类型:String
说明:任务进度百分比
data#
类型:根据任务类型不同而异
说明:
音乐生成任务:歌曲对象数组
歌词生成任务:歌词对象
歌曲对象#
id#
类型:String
说明:歌曲 ID
title#
类型:String
说明:歌曲标题
status#
类型:String
说明:歌曲状态
metadata#
类型:Object
说明:歌曲元数据
tags:歌曲风格标签
prompt:生成歌曲使用的歌词
duration:歌曲时长
error_type:错误类型
error_message:错误信息
audio_prompt_id:音频 prompt ID
gpt_description_prompt:灵感来源描述
audio_url#
类型:String
说明:歌曲音频的 URL 地址
image_url#
类型:String
说明:歌曲封面图的 URL 地址
video_url#
类型:String
说明:歌曲视频的 URL 地址
model_name#
类型:String
说明:生成歌曲使用的模型名称
major_model_version#
类型:String
说明:模型主版本号
歌词对象#
id#
类型:String
说明:歌词 ID
text#
类型:String
说明:歌词内容
title#
类型:String
说明:歌词标题
status#
类型:String
说明:歌词状态

🌟 最佳实践#

1.
提供尽量详细 、具体的歌曲或歌词生成提示,避免过于笼统或抽象
2.
查询任务状态时,轮询间隔建议为 2-5 秒,避免过于频繁
3.
灵感模式仅需提供 gpt_description_prompt 参数,API 会自动生成歌词、标题、标签等
4.
自定义模式需要提供 prompt、title、tags 参数,可以对歌曲有更多控制
5.
尽量使用最新版本的模型(如 chirp-v4),效果会更好
6.
使用回调通知功能(notify_hook 参数)可以降低轮询频率,提高效率
7.
音乐续写、拼接功能可以在原有音乐基础上,生成更加丰富、完整的作品
8.
注意处理可能出现的异常和错误,如网络超时、参数校验失败等
上一页
OpenAI 响应格式(Responses)
下一页
Xinference 重排序格式(Rerank)
Built with