- 平台接口
- OpenAI接口
- 音乐模型
- 图像模型
- 视频模型
创建音乐
POST
{{BASE_URL}}/suno/submit/music
1.
只需要提交以下参数
gpt_description_prompt
make_instrumental
mv
Suno 会自动生成 歌词、标题、风格标签
2.
需要提交参数
prompt
title
tags
make_instrumental
mv
请求参数
Body 参数application/json
continue_at
integer
续写时间点
continue_clip_id
string
续写的歌曲ID
gpt_description_prompt
string
GPT生成歌词说明
make_instrumental
boolean
是否纯音乐
mv
string
模型
prompt
string
歌词prompt
tags
string
tag
task_id
string
任务ID
title
string
标题
示例
{
"continue_at": 0,
"continue_clip_id": "string",
"gpt_description_prompt": "string",
"make_instrumental": true,
"mv": "string",
"prompt": "string",
"tags": "string",
"task_id": "string",
"title": "string"
}示例代码
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 'Content-Type: application/json' \
--data-raw '{
"continue_at": 0,
"continue_clip_id": "string",
"gpt_description_prompt": "string",
"make_instrumental": true,
"mv": "string",
"prompt": "string",
"tags": "string",
"task_id": "string",
"title": "string"
}'返回响应
🟢200成功
application/json
Body
id
string
任务ID
title
string
标题
handle
string
必需
status
string
状态
user_id
string
用户ID
is_liked
boolean
必需
metadata
object
必需
tags
string
必需
type
string
类型
prompt
string
prompt
stream
boolean
必需
history
null
必需
duration
number
必需
error_type
null
必需
error_message
null
必需
concat_history
null
必需
refund_credits
boolean
必需
audio_prompt_id
null
必需
gpt_description_prompt
null
必需
reaction
null
必需
audio_url
string
必需
image_url
string
必需
is_public
boolean
必需
video_url
string
必需
created_at
string
必需
is_trashed
boolean
必需
model_name
string
必需
play_count
integer
必需
display_name
string
必需
upvote_count
integer
必需
image_large_url
string
必需
is_video_pending
boolean
必需
is_handle_updated
boolean
必需
major_model_version
string
必需
示例
{
"id": "86e395cb-b4a8-50a7-a081-6a341a48064f",
"title": "City Lights",
"handle": "timelesssubgenre031",
"status": "complete",
"user_id": "1",
"is_liked": false,
"metadata": {
"tags": "emotional punk",
"type": "gen",
"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[Bridge]\n猫咪回忆 小鱼干\n跳舞奔跑 无忧烦\n一起歌唱 欢笑传\n猫咪摇滚 不会散\n\n[Chorus]\n喵 喵 喵喵喵\n猫咪歌声 在回荡\n喵 喵 喵喵喵\n喵星狂欢 到天亮",
"stream": true,
"history": null,
"duration": 125.44,
"error_type": null,
"error_message": null,
"concat_history": null,
"refund_credits": false,
"audio_prompt_id": null,
"gpt_description_prompt": null
},
"reaction": null,
"audio_url": "https://cdn1.suno.ai/86e395cb-b4a8-50a7-a081-6a341a48064f.mp3",
"image_url": "https://cdn1.suno.ai/image_86e395cb-b4a8-50a7-a081-6a341a48064f.png",
"is_public": false,
"video_url": "https://cdn1.suno.ai/86e395cb-b4a8-50a7-a081-6a341a48064f.mp4",
"created_at": "2024-07-08T10:06:28.420Z",
"is_trashed": false,
"model_name": "chirp-v3.5",
"play_count": 0,
"display_name": "TimelessSubgenre031",
"upvote_count": 0,
"image_large_url": "https://cdn1.suno.ai/image_large_86e395cb-b4a8-50a7-a081-6a341a48064f.png",
"is_video_pending": true,
"is_handle_updated": false,
"major_model_version": "v3.5"
}修改于 2025-04-21 16:18:45