奶鲨API(OpenAI)中文文档
  1. 定制suno接口
奶鲨API(OpenAI)中文文档
  • 发出请求
  • 模型接口
    • 完成对象
    • 模型(Models)
      • 列出模型
    • 聊天接口(Chat)
      • 聊天接口(通用)
      • Suno
      • Anthropic Claude(全系列,已更新支持第三代)
      • gpts
      • gemini-pro
      • gpt-4-all(分析图片)
      • gpt-4-all(生成图片)
      • gpt-4-turbo-2024-04-09(识图)
    • 查询令牌额度
      • 已用额度查询
    • 自动补全接口(Completions)
      • 内容补全接口
    • 图像接口(Images)
      • Midjourney API文档
        • InsightFace任务提交
          • 提交swap_face任务
        • 任务提交
          • 执行动作
          • 提交Blend任务
          • 提交Describe任务
          • 提交Imagine任务
          • 提交Modal
          • 提交Shorten任务
          • 上传文件到discord
        • 任务查询
          • 查询所有任务
          • 根据ID列表查询任务
          • 根据ID列表查询任务-字段displays
          • 分页查询任务
          • 查询任务队列
          • 取消任务
          • 指定ID获取任务
          • 获取任务图片的seed(需设置mj或niji的私信ID)
      • DALL·E 3
      • Stable-Diffusion
    • 向量生成接口(Embeddings)
      • 创建嵌入
    • 音频接口(Audio)
      • 创建转录
      • 创建翻译
      • TTS文本转语音
    • Suno音乐接口
      • Suno-V3.5
        • 生成音乐
        • 查询任务
    • 定制suno接口
      • suno定制接口
        POST
  • 帮助中心
    • 常见问题及解决办法
  1. 定制suno接口

suno定制接口

POST
https://suno.super-api.cn/bak2/api/suno
suno

suno音乐接口api/suno#

接口URL#

https://{url}/api/suno

url主:suno.super-api.cn/bak2#

备用联系客服处理

备用:suno.super-api.cn/bak1#

备用:suno.super-api.cn#

请求方式#

POST

Content-Type#

json

请求Header参数#

参数名示例值参数类型是否必填参数描述
Content-Typeapplication/jsonString是-
AuthorizationBearer SK-89Y0TE7XC4ASJUB797IIJWGH84O2724AString是鉴权密钥

请求Body参数#

参数名示例值参数类型是否必填参数描述
prompt[详细的歌词内容]String是歌词或音乐描述提示(自定义模式专用)
tags华语流行,民谣,钢琴,吉他,流行String是音乐标签,用逗号分隔(自定义模式专用)
title指引的光明String是歌曲标题(自定义模式专用)
gpt_description_promptString否灵感模式提示词(灵感模式专用)
continue_atNumber否歌曲延长时间,单位秒
continue_clip_idString否需要续写的歌曲id
infill_start_sNumber否填充开始时间(秒)
infill_end_sNumber否填充结束时间(秒)
make_instrumentalfalseBoolean是是否生成纯音乐,true为生成纯音乐
modelchirp-v3-5String是mv模型,可选值:chirp-v3-0、chirp-v3-5。不填默认为chirp-v3-0

请求Body示例#

{
    "prompt": "[verse 1]\n春天的微风轻抚过脸庞,\n樱花瓣随风翩翩起舞。\n你的笑容如阳光般温暖,\n照亮了我内心的角落。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[verse 2]\n漫步在绿意盎然的公园,\n鸟儿的歌声伴随我们。\n每一步都是新的冒险,\n每一刻都值得珍惜。\n\n[bridge]\n时光飞逝,岁月如歌,\n但我们的爱永远不变。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[outro]\n春天的旋律,永远在心中回响。",
    "tags": "华语流行,轻音乐,钢琴,吉他,春天",
    "title": "春天的旋律",
    "gpt_description_prompt": "创作一首描绘春天美好的中文流行歌曲,带有轻快的节奏和温暖的旋律。",
    "continue_at": null,
    "continue_clip_id": null,
    "infill_start_s": null,
    "infill_end_s": null,
    "make_instrumental": false,
    "model": "chirp-v3-5"
}

成功响应示例#

成功#

失败响应示例#

接口错误#

余额不足#

密钥验证失败#

示例代码#

Python#

PHP#

Java#

JavaScript#

请求参数

Header 参数
Content-Type
string 
可选
示例值:
application/json
Authorization
string 
鉴权密钥
可选
示例值:
Bearer SK-89Y0TE7XC4ASJUB797IIJWGH84O2724A
Body 参数application/json
prompt
string 
必需
歌词或音乐描述提示(自定义模式专用)
tags
string 
必需
音乐标签,用逗号分隔(自定义模式专用)
title
string 
必需
歌曲标题(自定义模式专用)
gpt_description_prompt
string 
必需
灵感模式提示词(灵感模式专用)
continue_at
number 
必需
歌曲延长时间,单位秒
continue_clip_id
string 
需要续写的歌曲id
必需
infill_start_s
number 
填充开始时间(秒)
必需
infill_end_s
number 
填充结束时间(秒)
必需
make_instrumental
boolean 
必需
是否生成纯音乐,true为生成纯音乐
model
string 
必需
mv模型,可选值:chirp-v3-0、chirp-v3-5。不填默认为chirp-v3-0
示例
{
    "prompt": "[verse 1]\n春天的微风轻抚过脸庞,\n樱花瓣随风翩翩起舞。\n你的笑容如阳光般温暖,\n照亮了我内心的角落。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[verse 2]\n漫步在绿意盎然的公园,\n鸟儿的歌声伴随我们。\n每一步都是新的冒险,\n每一刻都值得珍惜。\n\n[bridge]\n时光飞逝,岁月如歌,\n但我们的爱永远不变。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[outro]\n春天的旋律,永远在心中回响。",
    "tags": "华语流行,轻音乐,钢琴,吉他,春天",
    "title": "春天的旋律",
    "gpt_description_prompt": "创作一首描绘春天美好的中文流行歌曲,带有轻快的节奏和温暖的旋律。",
    "continue_at": null,
    "continue_clip_id": null,
    "infill_start_s": null,
    "infill_end_s": null,
    "make_instrumental": false,
    "model": "chirp-v3-5"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://suno.super-api.cn/bak2/api/suno' \
--header 'Authorization: Bearer SK-89Y0TE7XC4ASJUB797IIJWGH84O2724A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[verse 1]\n春天的微风轻抚过脸庞,\n樱花瓣随风翩翩起舞。\n你的笑容如阳光般温暖,\n照亮了我内心的角落。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[verse 2]\n漫步在绿意盎然的公园,\n鸟儿的歌声伴随我们。\n每一步都是新的冒险,\n每一刻都值得珍惜。\n\n[bridge]\n时光飞逝,岁月如歌,\n但我们的爱永远不变。\n\n[chorus]\n这是属于我们的季节,\n充满希望和新的开始。\n让我们携手共同前行,\n创造属于我们的故事。\n\n[outro]\n春天的旋律,永远在心中回响。",
    "tags": "华语流行,轻音乐,钢琴,吉他,春天",
    "title": "春天的旋律",
    "gpt_description_prompt": "创作一首描绘春天美好的中文流行歌曲,带有轻快的节奏和温暖的旋律。",
    "continue_at": null,
    "continue_clip_id": null,
    "infill_start_s": null,
    "infill_end_s": null,
    "make_instrumental": false,
    "model": "chirp-v3-5"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "status": "200",
    "result": [
        "https://audiopipe.suno.ai/?item_id=646821b0-022f-4a1e-a7c3-ca2b8aefacfd",
        "https://audiopipe.suno.ai/?item_id=a4a02d5c-2bf4-4764-b321-f54ce59f8e09"
    ]
}
🟢200系统错误
🟢200余额不足
🟢200鉴权失败
上一页
查询任务
下一页
常见问题及解决办法
Built with