帮助/API文档
  1. 任务提交
帮助/API文档
  • 系统使用介绍
  • API介绍
  • 项目说明
  • 导言
  • 身份验证
  • 发出请求
  • 参数详情
  • OpenAI
    • 聊天(Chat)
      • 聊天完成对象
      • 聊天完成块对象
      • gpt-4-all
        • gpt-4-all(识图)
        • gpt-4-all(生成图片)
      • GPT创建聊天(补全)接口
      • 识图(gpt和gemini)
      • gpts
      • gemini-pro
    • 音频(Audio)
      • 创建语音
      • 创建转录
      • 创建翻译
    • 图像(Images)
      • README
      • 图像对象
      • 创建图像
      • 创建图片编辑
      • 创建图像变体
    • 文件(Files)
      • README
      • 文件对象
      • 上传文件
      • 删除文件
      • 检索文件
      • 检索文件内容
      • 列出文件
    • 自动补全(Completions)
      • 完成对象
      • 创建完成
    • 嵌入(Embeddings)
      • 嵌入对象
      • 创建嵌入
  • 音乐接口
    • Suno
      • 常用格式
        • 说明
        • 异步调用(API形式)格式
          • 任务提交
            • 生成歌曲
              POST
            • 生成歌词
              POST
            • 上传音乐
              POST
            • 歌曲拼接
              POST
          • 任务查询
            • 查询任务
            • 查询歌词
        • OpenAI 聊天格式
          POST
        • GoAmzAI格式
          POST
    • udio
      • 常用格式
        • 说明
        • 异步调用(API形式)格式
          • 任务提交
            • 生成歌曲
            • 续写
          • 任务查询
            • 查询任务
  • 绘图接口
    • Mid journey文生图
      • 说明:接口说明及参数
      • 任务提交
        • 提交Describe任务(图生文)
        • 提交Imagine任务(文生图、文图生图)
        • 提交Blend任务(图生图)
        • 绘图变化(UPSCALE; VARIATION; REROLL)
        • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
        • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
        • 提交Modal(提交局部重绘、ZOOM)
        • 提交Shorten任务(prompt分析)
        • MJ上传图片获得url
        • 提交图片编辑任务
        • 提交Imagine任务(文生图、文图生图) Copy
      • 任务查询
        • 指定ID获取任务
        • 根据ID列表查询任务
        • 获取任务图片的seed
      • 提交swap_face任务
    • Flux文生图
      • 官方异步格式
        • flux生成图像
        • 指定ID获取任务
      • OpenAI 聊天格式
    • recraftv3文生图
      • OpenAI 聊天格式
      • OpenAI Dalle3格式
  • 视频接口
    • luma
      • 官方异步调用
        • 提交视频生成任务
        • 指定ID获取任务
      • GoAmzAI格式
        • 提交视频生成任务
        • 指定ID获取任务
      • OpenAI 聊天格式
    • runway
      • 官方异步调用
        • 提交视频生成任务
        • 指定ID获取任务
      • 简单格式(goamz/rocket)
        • 文本生成视频
        • 参考图片生成视频
        • video2video(视频转视频 风格重绘)
        • Act-one 表情迁移
        • 指定ID获取任务(免费)
    • pixverse
      • 提交视频生成任务
      • 指定ID获取任务
    • google-veo
      • 异步调用
        • 提交视频生成任务
        • 提交(带图)视频生成任务
        • 指定ID获取任务
      • OpenAI 聊天格式
    • veo Copy
      • 异步调用
        • 提交视频生成任务
        • 提交(带图)视频生成任务
        • 指定ID获取任务
      • OpenAI 聊天格式
  1. 任务提交

生成歌曲

POST
{{BASE_URL}}/suno/submit/music
支持官方格式:
{{BASE_URL}}/suno/generate
{{BASE_URL}}/suno/generate/description-mode
分为3种模式
1.灵感模式:
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成 歌词、标题、风格标签
2.自定义模式:
需要提交参数
prompt
title
tags
make_instrumental
mv
3.续写
需要在自定义模式基础上携带
task_id
continue_at
continue_clip_id

请求参数

Authorization
Header 参数
Authorization
string 
可选
示例值:
Bearer {{YOUR_API_KEY}}
Content-Type
string 
可选
示例值:
application/json
Accept
string 
可选
示例值:
application/json
Body 参数application/json
prompt
string 
必需
歌词 (自定义模式专用)
mv
string 
必需
mv模型,chirp-v3-0、chirp-v3-5。不写默认 chirp-v3-0
title
string 
必需
标题(自定义模式专用)
tags
string 
必需
风格标签(自定义模式专用)
make_instrumental
boolean 
必需
是否生成纯音乐,true 为生成纯音乐
task_id
string 
必需
任务id,用于对之前的任务再操作
continue_at
number 
必需
float,歌曲延长时间,单位秒
continue_clip_id
string 
必需
歌曲id,需要续写哪首歌
gpt_description_prompt
string 
必需
灵感模式提示词(灵感模式专用)
示例
1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "emotional punk",
    "mv": "chirp-v3-0",
    "title": "City Lights"
}

3.续写
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "bass-driven atmospheric heavy metal",
    "mv": "chirp-v3-0",
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac"
    "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
    "continue_at": 80
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{BASE_URL}}/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '1.灵感模式

{
    "gpt_description_prompt": "cat"
}

2.自定义模式
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "emotional punk",
    "mv": "chirp-v3-0",
    "title": "City Lights"
}

3.续写
{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'\''m alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it'\''s music to my ears\nThe hustle and the bustle\nWiping away my fears",
    "tags": "bass-driven atmospheric heavy metal",
    "mv": "chirp-v3-0",
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac"
    "continue_clip_id": "ce2cfbce-9ea0-45b0-9386-020c0ff54a49",
    "continue_at": 80
}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
message
string 
必需
data
string 
task_id
必需
示例
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
修改于 2025-03-28 12:56:11
上一页
说明
下一页
生成歌词
Built with