- 指南
- 获取 Base URL 和 API Key
- 通知设置-WebHook参数介绍
- 配置方式
- 列出模型
- 聊天(Chat)
- RAG(嵌入、重排序
- 视频模型
- 数字人
- 绘图模型
- 生图模型简介
- OpenAI Dall-e 格式
- OpenAI 聊天格式
- Mid journey 文生图
- Flux 文生图
- Ideogram(官方格式
- recraft 官方格式
- 快手可 灵(官方格式)
- SeedEdit(图片编辑
- Replicate
- 接入教程
- 获取任务进度(predictions (免费
- 创建任务-通过模型version(predictions)
- 创建任务-通过url路径
- 创建任务-stability-ai/stable-diffusion
- 创建任务-stability-ai/sdxl
- 创建任务-stability-ai/stable-diffusion-inpainting
- 创建任务-stability-ai/stable-diffusion-img2img
- 创建任务-lucataco/flux-schnell-lora
- 创建任务-lucataco/flux-dev-lora
- 创建任务-andreasjansson/stable-diffusion-animation
- 创建任务-lucataco/animate-diff
- 创建任务-sujaykhandekar/object-removal
- 创建任务-cjwbw/rembg
- 创建任务-black-forest-labs/flux-1.1-pro
- 创建任务-black-forest-labs/flux-1.1-pro-ultra
- 创建任务-black-forest-labs/flux-dev
- 创建任务-black-forest-labs/flux-pro
- 创建任务-black-forest-labs/flux-schnell
- 创建任务-minimax/video-01-live
- 创建任务-minimax/video-01
- 创建任务-recraft-ai/recraft-v3
- 创建任务-recraft-ai/recraft-v3-svg
- 创建任务-ideogram-ai/ideogram-v2-turbo
- 豆包智能绘图
- 音频接口
- Suno文生歌
- 补充
- 音乐生成参数介绍
- 场景一: 灵感模式
- 场景二: 自定义.歌词歌名
- 场景三: 纯音乐.自定义
- 场景四: 纯音乐.灵感模式
- 场景五: 续写自定义音频
- 场景六: 续写音乐并获取完整音乐
- 场景七: Cover 音乐翻版\修改风格
- 场景八: Replace Section.替换片段
- 场景九: Persona.歌手风格
- 场景十: 上传续写
- 生成歌曲(灵感模式)POST
- 生成歌曲(自定义模式)POST
- 生成歌曲(续写模式)POST
- 生成歌曲(歌手风格) POST
- 生成歌曲(上传歌曲二次创作)POST
- 生成歌曲(拼接歌曲)POST
- 生成歌词POST
- 上传请求POST
- 报告上传完毕POST
- 查询上传处理状态GET
- 初始化音频文件POST
- Persona:创建歌手风格POST
- 查询歌词GET
- 查询歌曲GET
- 批量获取任务POST
- 声曲分离GET
- Timing:歌词、音频时间线GET
- wav:获取 wav 格式文件GET
- mp4:生成 mp4 mv 视频GET
- 上传音乐通过 urlPOST
- 生成歌曲 (v1 版本)POST
- 拼接歌曲 (v1 版本)POST
- 生成歌词 (v1 版本)POST
- 查询歌曲 (v1 版本)GET
- 查询歌词 (v1 版本)GET
- OpenAI(TTS\Wishper
- 文件上传(Files)
- PPT接口
- 帮助中心
- 平台API
- 废弃、未开放
生成歌曲(上传歌曲二次创作)
POST
{{BASE_URL}}/suno/submit/music
最后修改时间:2025-05-12 11:54:27
请求参数
Header 参数
accept
string
可选
示例值:
*/*
authorization
string
必需
示例值:
Bearer {{YOUR_API_KEY}}
content-type
string
必需
示例值:
application/json
Body 参数application/json
prompt
string
必需
mv
string
必需
title
string
必需
tags
string
必需
continue_at
integer
必需
continue_clip_id
string
必需
task
string
必需
make_instrumental
boolean
必需
示例
{
"prompt": "歌词",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "标题",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}
示例代码
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 'accept: */*' \
--header 'authorization: Bearer {{YOUR_API_KEY}}' \
--header 'content-type: application/json' \
--data-raw '{
"prompt": "歌词",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "标题",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}'
返回响应
🟢200成功
application/json
Body
object {0}
示例
{
"clips": [
{
"allow_comments": true,
"audio_url": "",
"avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
"created_at": "2025-04-29T07:29:45.897Z",
"display_name": "WhimsicalJPop3254",
"entity_type": "song_schema",
"flag_count": 0,
"handle": "whimsicaljpop3254",
"id": "853daa2c-fbf9-4cd0-a90a-e2b18c53c174",
"is_handle_updated": false,
"is_liked": false,
"is_public": false,
"is_trashed": false,
"major_model_version": "v4",
"metadata": {
"can_remix": true,
"edited_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
"history": [
{
"continue_at": 123,
"id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
"infill": false,
"source": "web",
"type": "gen"
}
],
"infill": false,
"is_remix": false,
"priority": 10,
"prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
"stream": true,
"tags": "romantic raga",
"task": "extend",
"type": "gen"
},
"model_name": "chirp-v4",
"play_count": 0,
"status": "submitted",
"title": "Cat Dance",
"upvote_count": 0,
"user_id": "e1f7ab94-b6ec-4a1a-b2bb-c3ca772a956d",
"video_url": ""
},
{
"allow_comments": true,
"audio_url": "",
"avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
"created_at": "2025-04-29T07:29:45.897Z",
"display_name": "WhimsicalJPop3254",
"entity_type": "song_schema",
"flag_count": 0,
"handle": "whimsicaljpop3254",
"id": "10df3c14-c755-40e9-87d8-830bfe3c3b9c",
"is_handle_updated": false,
"is_liked": false,
"is_public": false,
"is_trashed": false,
"major_model_version": "v4",
"metadata": {
"can_remix": true,
"edited_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
"history": [
{
"continue_at": 123,
"id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
"infill": false,
"source": "web",
"type": "gen"
}
],
"infill": false,
"is_remix": false,
"priority": 10,
"prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
"stream": true,
"tags": "romantic raga",
"task": "extend",
"type": "gen"
},
"model_name": "chirp-v4",
"play_count": 0,
"status": "submitted",
"title": "Cat Dance",
"upvote_count": 0,
"user_id": "e1f7ab94-b6ec-4a1a-b2bb-c3ca772a956d",
"video_url": ""
}
],
"id": "669121dd-22a3-41d7-a1f9-d939e6623b91",
"status": "complete"
}