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

使用 persona_id 创作音乐

测试中
POST
https://api.deerapi.com/suno/generate
注意 mv 为 chirp-v3-5-tau 或者 chirp-v4-tau 或者 chirp-auk
task 为 artist_consistency
persona_id 为 新建personal 步骤得到的
artist_clip_id 就是 新建personal 步骤中的 clip_id
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.deerapi.com/suno/generate' \
--header 'Authorization: Bearer {{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": "6a40ce76-2fbe-4272-8ccb-568ed0be7eda",
    "artist_clip_id": "117decaa-d0d1-4847-bcb0-9042086c433c"
}'
响应示例响应示例
{
    "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
}

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200Successful Response
application/json
Body

修改于 2025-07-01 06:51:25
上一页
批量查询任务
下一页
生成音乐
Built with