kksjAPI(OpenAI)中文文档 copy
  1. suno
kksjAPI(OpenAI)中文文档 copy
  • 发出请求
  • 模型接口
    • 图像接口(Images)
      • Midjourney Proxy API文档
        • InsightFace任务提交
          • 提交swap_face任务
        • 任务提交
          • 执行动作
          • 提交Blend任务
          • 提交Describe任务
          • 提交Imagine任务
          • 提交Modal
          • 提交Shorten任务
          • 上传文件到discord
        • 任务查询
          • 分页查询任务
          • 查询任务队列
          • 取消任务
          • 指定ID获取任务
          • 获取任务图片的seed(需设置mj或niji的私信ID)
    • 音乐生成接口
      • suno
        • 音乐生成接口
          POST
        • 生成歌词接口
          POST
        • 查询单个任务接口
          GET
        • 批量查询接口
          POST
    • 视频生成接口
      • vidu接口
        • 创建视频
        • 视频查询
      • luma接口
        • 创建视频
        • 视频查询
        • 视频拓展
      • runway接口
        • 创建视频
        • 视频查询
      • cogvideox接口
        • 创建视频
        • 视频查询
  • 帮助中心
    • 常见问题及解决办法
  1. suno

音乐生成接口

POST
/suno/submit/music

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Accept
string 
必需
示例值:
application/json
Authorization
string 
可选
示例值:
Bearer {{YOUR_API_KEY}}
Body 参数application/json
prompt
string 
可选
歌词 (自定义模式专用)
mv
string 
可选
mv模型,chirp-v3-0、chirp-v3-5。不写默认 chirp-v3-0
title
string 
可选
风格标签(自定义模式专用)
make_instrumental
boolean 
必需
是否生成纯音乐,true 为生成纯音乐
task_id
string 
可选
任务id,用于对之前的任务再操作
continue_at
string 
可选
float,歌曲延长时间,单位秒
continue_clip_id
string 
可选
歌曲id,需要续写哪首歌
gpt_description_prompt
string 
可选
灵感模式提示词(灵感模式专用)
notify_hook
string 
可选
回调地址: https://xxxxxxx
示例
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 --request POST 'https://api.kksj.me/suno/submit/music' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--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
}'

返回响应

🟢200OK
application/json
Body
code
string 
必需
message
string 
必需
data
string 
task_id
必需
示例
{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
修改于 2024-08-19 16:38:29
上一页
获取任务图片的seed(需设置mj或niji的私信ID)
下一页
生成歌词接口
Built with