DeerAPI-API文档
  1. Suno
DeerAPI-API文档
  • 快速开始
    • 快速开始
    • 入门必看
    • DeerAPI 公告
  • API 参考
    • 报错状态码说明
    • OpenAI格式
      • 聊天
      • response
      • gpt-4o-image生图
      • 识图
      • 图像
      • 图像编辑(gpt-image-1)
      • 嵌入
      • Realtime
      • 获取模型列表
      • response id获取结果
    • Anthropic 格式
      • Anthropic Claude
    • Midjourney 图像生成
      • 快速教学-完整流程一遍过
      • 任务查询
        • 分页查询
        • 指定ID获取任务
      • 提交Imagine任务
      • 提交视频任务
      • 提交编辑任务
      • 提交Action任务
      • 提交Blend任务
      • 提交Describe任务
      • 提交Modal
    • 图像生成
      • ideogram(images)
        • 官方文档(实时更新)
        • Generate 3.0(文生图)
        • Reframe 3.0(重构)
        • Replace Background 3.0(背景替换)
        • Remix 3.0(混合图)
        • Edit 3.0(编辑)
        • Generate(文生图)
        • Remix(混合图)
        • Upscale(放大高清)
        • Describe(描述)
        • Edit(编辑)
      • Replicate(image)
        • 创建任务-通用
        • 创建任务 -flux-kontext-pro、max
        • 创建任务-black-forest-labs/flux-1.1-pro
        • 创建任务-black-forest-labs/flux-1.1-pro-ultra
        • 查询任务
        • 创建任务
      • Flux(images)
        • 创建任务-通用
        • 生成图片
        • 微调(暂不可用)
        • 查询任务
        • 生成图片(replicate格式)
      • Recraft(images)
        • 附录
        • Generate Image(生成图片)
        • Vectorize Image(矢量化图片)
        • Remove Background(删除背景)
        • Clarity Upscale(清晰度提升)
        • Create style(创建样式)
        • Generative Upscale(生成高清)
    • 音乐生成
      • Suno
        • 设置 suno 版本
        • Suno API 场景应用指南
        • 生成歌词
          POST
        • 生成音乐
          POST
        • 上传音乐
          POST
        • 歌曲拼接
          POST
        • 全轨声曲分离
          POST
        • 单轨声曲分离
          POST
        • 新建 Persona
          POST
        • 查询单个任务
          GET
        • 生成 mp4 mv 视频
          GET
        • 获取 wav 格式文件
          GET
        • Timing:歌词、音频时间线
          GET
        • 批量查询任务
          POST
        • 使用 persona_id 创作音乐
          POST
      • Udio(暂不可用)
        • 生成音乐
        • 查询单个任务
    • 视频生成
      • veo3
        • veo3-chat格式
        • 提交视频生成任务-测试中
        • 查询视频生成状态-测试中
      • seedace测试中
        • 视频-测试中
          • seedance
          • seedance-video
          • seedance-video get
        • 图片
          • seedance-image-generation
          • seedance-image-edits
      • runway(video)
        • 官方格式
          • 从图像生成视频
          • 获取任务详细信息
        • 逆向格式
          • generate(文本)
          • generate(参考图片)
          • video2video 视频转视频 风格重绘
          • Act-one 表情迁移
          • feed-获取任务
      • kling (video)
        • Callback协议
        • 多模态视频编辑测试中
          • 初始化待编辑视频
          • 增加视频选区
          • 删减视频选区
          • 清除视频选区
          • 预览已选区视频
          • 创建任务
        • 扩图
        • 生成图像
        • 文生视频
        • 图生视频
        • 多图参考生视频
        • 视频延长
        • 虚拟试穿
        • 对口型
        • 视频特效
        • 文生音效
        • 视频生音效
        • 查询任务(单个)
      • luma (video)
        • 官方API格式
          • 生成视频
          • 单个查询任务
      • MiniMax 海螺(video)
        • 官方文档
        • 视频生成
        • 查询任务
        • 文件下载
      • PIKA(video)
        • 通用版
          • generate video
          • 查询视频任务
        • generate(参考视频/扩展视频)
        • generate(参考图片)
        • generate(文本)
        • feed
      • sora
        • 逆向格式
          • 创建视频
          • 生成视频
          • 查询视频任务
    • 音频
      • 文本转音频
      • 音频转文本
      • 创建翻译
  • 代码示例
    • 代码示例
  • 集成指南
    • 应用集成指南
      • DeerAPI 本站调用
      • OpenManus
      • Chatbox
      • CherryStudio
      • Cursor
      • Lobe-Chat
      • NEXT CHAT (ChatGPT Next Web)
      • cline
      • gptme
      • LangChain
      • AnythingLLM
      • ChatHub
      • ChatAll
      • Zotero
      • librechat
      • avante.nvim
      • Dify
      • OpenAI Translator
      • Open WebUI
      • obsidian的text generator插件
      • STranslate
      • 沉浸式翻译
      • Pot 翻译
      • 欧陆翻译
      • utools-ChatGPT 好友
      • GPT 学术优化(gpt_academic)
      • 懒人客服
      • IntelliJ Translation Plugin
      • FastGPT
      • COZE
    • 最佳实践
      • Claude code 接入说明
      • Deerapi 账户余额查询API 使用说明
      • 使用 DeerAPI 和 OpenAI 官方 API 的重试逻辑说明文档
      • Midjorney调用最佳实践
      • Runway调用最佳实践
      • Gemini CLI 接入说明
  • 定价计费
    • 关于价格
    • 关于分组
  • 帮助中心
    • 帮助中心
    • 接口稳定性
    • 常见误区
    • 使用困惑
    • 隐私政策
    • 服务条款
  1. Suno

生成音乐

POST
https://api.deerapi.com/suno/submit/music

生成音乐片段#

通过该端点,您可以生成具有特定细节的音乐片段。有三种模式,可用于不同情况。

模式#

灵感:只需要一个主题,歌词和音乐风格都将由人工智能决定。
自定义:需要歌词、音乐风格和歌曲名称,以创建您的自定义音乐片段
歌曲续编:参数与剪辑模式几乎相同,但多了一些用于查找之前的音乐片段并根据您的指示继续生成的参数: “task_id“、”continue_clip_id“、”continue_at“、”task"。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.deerapi.com/suno/submit/music' \
--header 'Authorization: Bearer {{api-key}}' \
--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"
}'
响应示例响应示例
{
    "code": "success",
    "message": "",
    "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200Successful Response
application/json
Body

修改于 2025-07-02 09:00:59
上一页
生成歌词
下一页
上传音乐
Built with