DeerAPI-API文档
  1. Suno
DeerAPI-API文档
  • 快速开始
    • 快速开始
    • 入门必看
    • DeerAPI 公告
  • API 参考
    • 报错状态码说明
    • OpenAI格式
      • Chat Completions
      • Responses
      • gpt-4o-image生图
      • 图像
      • 图像编辑(gpt-image-1)
      • Embeddings
      • 获取模型列表
      • response id获取结果
      • Hunyuan3D
    • Anthropic 格式
      • Anthropic Claude
    • Gemini
      • 调用 gemini-3-pro-image 指南
      • Gemini生图
      • Gemini 文本对话
    • Midjourney 图像生成
      • 快速教学-完整流程一遍过
      • 任务查询
        • 分页查询
        • 指定ID获取任务
      • 提交Imagine任务
      • 提交视频任务
      • 提交编辑任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
    • 图像生成
      • Replicate(image)
        • 创建任务-通用
        • 查询任务
      • 豆包生图
        • seededit-image-generation
        • seededit-Image Editing
      • Flux(images)
        • 创建任务-replicate格式
        • 生成图片
        • 查询任务
        • 生成图片(replicate格式)
    • 音乐生成
      • Suno
        • 设置 suno 版本
        • Suno API 场景应用指南
        • 生成歌词
          POST
        • 生成音乐
          POST
        • 上传音乐
          POST
        • 歌曲拼接
          POST
        • 全轨声曲分离
          POST
        • 单轨声曲分离
          POST
        • 新建 Persona
          POST
        • 拓展 style tags
          POST
        • 查询单个任务
          GET
        • 生成 mp4 mv 视频
          GET
        • 获取 wav 格式文件
          GET
        • Timing:歌词、音频时间线
          GET
        • 批量查询任务
          POST
        • 获取 midi
          GET
    • 视频生成
      • sora-2
        • 官方格式
          • 创建视频
          • 混编视频
          • 检索视频
          • 下载视频
        • 逆向
          • 逆向异步格式
            • sora逆向异步
            • sora逆向查回
          • sora-2视频逆向格式
      • veo3
        • 逆向异步格式
          • veo3逆向异步
          • veo3逆向查回
        • veo3-chat格式
      • kling (video)
        • Callback协议
        • 多模态视频编辑
          • 初始化待编辑视频
          • 增加视频选区
          • 删减视频选区
          • 清除视频选区
          • 预览已选区视频
          • 创建任务
        • 文生视频
        • 图生视频
        • 多图参考生视频
        • 视频延长
        • 语音合成
        • Kling 数字人创建任务
        • 【对口型】人脸识别
        • 【对口型】创建任务
        • 视频特效
        • 文生音效
        • 视频生音效
        • 图像生成
        • 多图参考生图
        • 扩图
        • 图像识别
        • 虚拟试穿
        • 查询任务(单个)
      • runway(video)
        • 官方格式
          • 图像生成视频
          • 视频生视频
          • 提升清晰度
          • 文生图
          • 控制角色
          • 获取任务详细信息
        • 逆向格式
          • generate(文本)
          • generate(参考图片)
          • video2video 视频转视频 风格重绘
          • Act-one 表情迁移
          • feed-获取任务
      • MiniMax 海螺(video)
        • 官方文档
        • 视频生成
        • 查询任务
        • 文件下载
      • seedace测试中
        • 视频-测试中
          • seedance
          • seedance-video
          • seedance-video get
      • luma (video)
        • 官方API格式
          • 生成视频
          • 单个查询任务
    • 音频
      • 文本转音频
      • 音频转文本
      • 创建翻译
  • 代码示例
    • 代码示例
  • 集成指南
    • 应用集成指南
      • DeerAPI 本站调用
      • OpenManus
      • Chatbox
      • CherryStudio
      • COZE
      • Cursor
      • Lobe-Chat
      • NEXT CHAT (ChatGPT Next Web)
      • AnythingLLM
      • cline
      • gptme
      • LangChain
      • ChatHub
      • ChatAll
      • Dify
      • Zotero
      • librechat
      • avante.nvim
      • IntelliJ Translation Plugin
      • FastGPT
      • OpenAI Translator
      • Open WebUI
      • obsidian的text generator插件
      • STranslate
      • 沉浸式翻译
      • Pot 翻译
      • 欧陆翻译
      • GPT 学术优化(gpt_academic)
      • utools-ChatGPT 好友
      • 懒人客服
    • 最佳实践
      • Claude code 接入说明
      • Deerapi 账户余额查询API 使用说明
      • 使用 DeerAPI 和 OpenAI 官方 API 的重试逻辑说明文档
      • Midjorney调用最佳实践
      • Runway调用最佳实践
  • 定价计费
    • 关于价格
    • 关于分组
  • 帮助中心
    • 帮助中心
    • 接口稳定性
    • 常见误区
    • 使用困惑
    • 隐私政策
    • 服务条款
  1. Suno

生成音乐

POST
https://api.deerapi.com/suno/submit/music
/suno/submit/music 接口允许您生成具有特定细节的音乐片段。共有六种模式可用于不同的场景。
提交音乐生成请求后,您可以使用返回的 task_id 通过 单任务查询 接口查询生成结果并跟踪任务状态。
💡 完整请求示例: 我们已在下方的代码示例部分提供了所有六种模式的完整 JSON 请求示例,请参考这些示例以了解详细的参数用法和结构。

模式说明#

1.
灵感模式(Inspiration Mode):只需提供一个主题,歌词和音乐风格都将由 AI 决定。
2.
自定义模式(Custom Mode):需要提供歌词、音乐风格和歌曲标题来创建您的自定义音乐作品。
3.
歌曲续写模式(Song Continuation):与自定义模式参数几乎相同,但需要额外几个参数来定位您之前的音乐片段并根据您的指示继续生成:task_id、continue_clip_id、continue_at、task。
4.
人设模式(Persona Mode):使用特定的艺术家人设创建具有一致风格的音乐。
5.
配音模式(Dubbing Mode):为现有音频添加器乐伴奏。
6.
填词模式(Lyrics Mode):为现有器乐音轨添加人声。

1. 灵感模式#

gpt_description_prompt(字符串):音乐生成的提示词。基本上是一句话或几个词来描述您希望歌曲的主题。
mv(字符串):音乐模型的版本(例如:chirp-auk)。

2. 自定义模式#

prompt(字符串):音乐提交的歌词。
tags(字符串):与提交相关的音乐风格标签。
mv(字符串):音乐模型的版本(例如:chirp-v4)。
title(字符串):音乐提交的标题。

3. 歌曲续写模式#

prompt(字符串):音乐续写的歌词。
tags(字符串):与提交相关的音乐风格标签。
negative_tags(字符串):音乐生成中要避免的标签。
mv(字符串):音乐模型的版本。
title(字符串):音乐提交的标题。
task_id(字符串):原始任务的标识符。
continue_clip_id(字符串):要继续的片段标识符。
continue_at(数字):音乐中继续的位置(以秒为单位)。
task(字符串):必须设置为 "extend"。

4. 使用人设创建音乐#

使用先前创建的人设,以一致的艺术家风格创建音乐。
prompt(字符串):音乐提交的歌词。
generation_type(字符串):生成类型(例如:"TEXT")。
tags(字符串):音乐风格标签。
negative_tags(字符串):要避免的标签。
mv(字符串):音乐模型的版本。
title(字符串):音乐提交的标题。
task_id(字符串):任务的标识符。
task(字符串):任务类型标识符。
persona_id(字符串):从创建人设接口获得的人设标识符。
artist_clip_id(字符串):来自先前音乐生成步骤的片段 ID。
⚠️ 人设模式重要注意事项:
mv 必须是以下之一:chirp-v3-5-tau、chirp-v4-tau 或 chirp-auk
task 必须设置为 "artist_consistency"
persona_id 是从创建新人设接口获得的 ID
artist_clip_id 是从生成音乐步骤中获得的 clip_id

5. 配音模式(伴奏)#

为现有音频内容添加器乐伴奏。
mv(字符串):音乐模型的版本(例如:chirp-bluejay)。
tags(字符串):对所需器乐风格的详细描述。
title(字符串):输出的标题。
underpainting_clip_id(字符串):要添加伴奏的片段 ID。
underpainting_start_s(数字):开始时间(以秒为单位)。
underpainting_end_s(数字):结束时间(以秒为单位)。
task(字符串):必须设置为 "underpainting"。
prompt(字符串):纯器乐生成时可以为空。
override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。

6. 填词模式(人声)#

为现有器乐音轨添加人声层。
mv(字符串):音乐模型的版本(例如:chirp-bluejay)。
tags(字符串):对所需人声风格和音乐特征的详细描述。
title(字符串):输出的标题。
overpainting_clip_id(字符串):要添加人声的片段 ID。
overpainting_start_s(数字):开始时间(以秒为单位)。
overpainting_end_s(数字):结束时间(以秒为单位)。
task(字符串):必须设置为 "overpainting"。
prompt(字符串):要演唱的歌词。
override_fields(数组):要覆盖的字段(例如:["prompt", "tags"])。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200Successful Response
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.deerapi.com/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '1.灵感模式

{
    "mv": "chirp-auk",
    "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-v4",
    "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",
    "negative_tags": "dance",
    "mv": "chirp-v4", // 上传后续写 chirp-v4-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"
}

4.使用 persona_id 创作音乐
*   **注意事项:**
 *  mv 为 chirp-v3-5-tau 或者 chirp-v4-tau 或者 chirp-auk
 *  task 为 artist_consistency
 *  persona_id 为 新建persona 接口 步骤得到的返回id
 *  artist_clip_id 就是 生成音乐 步骤中的 clip_id

{
    "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_id": "f8fa553b-62a5-4091-9b5f-06e6f8817976",
    "task": "artist_consistency",
    "persona_id": "05bf9685-ab17-4b3b-93f6-0537f13f9e17",
    "artist_clip_id": "bd9cfdee-2010-4fdd-ab08-eaa6ac6a86d8"
}
5.配音:
{
    "mv": "chirp-bluejay",
    "tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
    "title": "Hi Insterumental",
    "underpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
    "underpainting_start_s": 0,
    "underpainting_end_s": 37.9,
    "task": "underpainting",
    "prompt": "",
    "override_fields": [
        "prompt",
        "tags"
    ]
}
6.填词:
{
    "mv": "chirp-bluejay",
    "tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
    "title": "Hi vocal",
    "overpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
    "overpainting_start_s": 0,
    "overpainting_end_s": 37.9,
    "task": "overpainting",
    "prompt": "yourself ",
    "override_fields": [
        "prompt",
        "tags"
    ]
}'
响应示例响应示例
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}
修改于 2025-11-24 03:27:20
上一页
生成歌词
下一页
上传音乐
Built with