API4GPT Docs
  1. v4.0
API4GPT Docs
  • 平台简介
  • 通用CHAT格式请求
  • 模型接口
    • 聊天接口(Chat)
      • 聊天接口
      • gpts
      • gemini-pro
      • gpt-4-all(分析图片)
      • gpt-4-vision-preview
    • 自动补全接口(Completions)
      • 内容补全接口
    • 图像接口(Images)
      • Midjourney
        • 补充 - 其他参数以及回调
        • InsightFace任务提交
          • 提交swap_face任务
        • 任务提交
          • 执行动作
          • 提交Blend任务
          • 提交Describe任务
          • 提交Imagine任务
          • 提交Modal
          • 提交Shorten任务
        • 任务查询
          • 查询所有任务
          • 根据ID列表查询任务
          • 分页查询任务
          • 查询任务队列
          • 取消任务
          • 指定ID获取任务
          • 获取任务图片的seed(需设置mj或niji的私信ID)
      • gpt-image-1
        • Image-1 生成
        • Image-1 编辑
      • Flux
        • 图片生成(普通flux)
        • 图片生成(kontext)
        • 图片编辑(kontext)
      • DALL·E 3
      • Stable-Diffusion
      • gpt-4-all(生成图片)
    • 向量生成接口(Embeddings)
      • 创建嵌入
    • 音频接口(Audio)
      • 创建转录
      • 创建翻译
      • TTS文本转语音
    • Suno音乐接口
      • v3.0
        • 生成音乐
        • 获取音乐
        • 合并音乐
      • v3.5
        • 生成音乐
        • 获取音乐
      • v4.0
        • 生成音乐
          POST
        • 生成歌词
          POST
        • 任务查询_单个
          GET
        • 任务查询_批量
          POST
    • Luma视频接口
      • luma
        • /generations
        • /extend
        • /task
      • lumvip
        • /generations
        • /extend
        • /task
    • 智谱视频接口
      • /generations(生成)
      • /result (获取结果)
    • 数字人
      • 生成数字人视频
      • 获取任务详情
  • 帮助中心
    • 常见问题及解决办法
  1. v4.0

生成音乐

POST
https://one.api4gpt.com/suno/submit/music

请求参数

Header 参数
Authorization
string 
必需
在 Header 添加参数 Authorization,其值为在 Bearer 之后拼接 Token
示例值:
Bearer Token
Body 参数application/json
prompt
string 
必需
歌词 (自定义模式专用)
mv
enum<string> 
可选
版本号,填写chirp-v4或chirp-v3-5,当前默认为chirp-v3-5
枚举值:
chirp-v3-5chirp-v4
title
string 
可选
标题(自定义模式专用)
tags
string 
可选
风格标签(自定义模式专用),如:tarantella, house, witch house, electro, pop, rock, punk, rap, metal, swing, funk, electro swing, pop rock, classic dubstep, chinese folk, french dub
negative_tags
string 
可选
make_instrumental
boolean 
必需
是否生成纯音乐,true 为生成纯音乐
task_id
string 
可选
任务id,用于对之前的任务再操作
continue_at
number 
可选
float,歌曲延长时间,单位秒
continue_clip_id
string 
可选
歌曲id,需要续写哪首歌
task
string 
上传后续写必填
可选
示例值: extend
gpt_description_prompt
string 
可选
灵感模式提示词(灵感模式专用)
notify_hook
string 
可选
回调地址: https://abc.com
示例
1.灵感模式

{
    "gpt_description_prompt": "dog"
}

2.自定义模式
{
    "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喜气洋洋心欢跳",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title":"2025元旦快乐",
}

3.续写模式(暂未启用上传接口)
{
    "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喜气洋洋心欢跳", // 可以空 ""
    "tags": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v3-5", // 上传后续写 chirp-v3-5-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id,不是clip_id
    "continue_at": 80,
    "task": "extend" 
}

示例代码

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://one.api4gpt.com/suno/submit/music' \
--header 'Authorization: Bearer Token' \
--header 'Content-Type: application/json' \
--data-raw '1.灵感模式

{
    "gpt_description_prompt": "dog"
}

2.自定义模式
{
    "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喜气洋洋心欢跳",
    "tags": "emotional punk",
    "mv": "chirp-v4",
    "title":"2025元旦快乐",
}

3.续写模式(暂未启用上传接口)
{
    "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喜气洋洋心欢跳", // 可以空 ""
    "tags": "bass-driven atmospheric heavy metal",
    "negative_tags": "dance",
    "mv": "chirp-v3-5", // 上传后续写 chirp-v3-5-upload
    "title": "City Lights",
    "task_id": "736a6f88-bd29-4b1e-b110-37132a5325ac",
    "continue_clip_id": "736a6f88-bd29-4b1e-b110-37132a5325ac_1", // 填写结尾带序号的id,不是clip_id
    "continue_at": 80,
    "task": "extend" 
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "code": "success",
    "data": "616299f7-97fa-b517-79a5-124f05b684ee"
}
修改于 2025-01-03 02:51:26
上一页
获取音乐
下一页
生成歌词
Built with