- 指南
- 获取 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:22
请求参数
Header 参数
accept
string
可选
示例值:
*/*
authorization
string
必需
示例值:
Bearer {{YOUR_API_KEY}}
content-type
string
必需
示例值:
application/json
Body 参数application/json
prompt
string
必需
generation_type
string
必需
tags
string
必需
negative_tags
string
必需
mv
string
必需
title
string
必需
task
string
必需
persona_id
string
必需
artist_clip_id
string
必需
示例
{
"prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "老公",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}
示例代码
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": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
"generation_type": "TEXT",
"tags": "electronic, pop",
"negative_tags": "",
"mv": "chirp-v4-tau",
"title": "老公",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}'
返回响应
🟢200成功
application/json
Body
object {0}
示例
{
"id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
"clips": [
{
"id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "老公",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
{
"id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
"video_url": "",
"audio_url": "",
"major_model_version": "v4",
"model_name": "chirp-v4",
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"is_liked": false,
"user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
"display_name": "TwinklingVenue1595",
"handle": "twinklingvenue1595",
"is_handle_updated": false,
"avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
"is_trashed": false,
"created_at": "2024-12-23T10:37:43.596Z",
"status": "submitted",
"title": "老公",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
],
"metadata": {
"tags": "electronic, pop",
"prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
"type": "gen",
"stream": true,
"has_vocal": false,
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task": "artist_consistency"
},
"major_model_version": "v4",
"status": "complete",
"created_at": "2024-12-23T10:37:43.581Z",
"batch_size": 1
}