音乐生成 · 创建音乐任务

提交音乐生成、续写、翻唱、分轨或混音任务,返回平台任务 ID。

基本信息

字段内容
应用编码music_generation
API 编码create
请求方式POST
请求路径/api/v1/apps/music_generation/create
调用模式异步

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

计费

按次固定扣费,不同 type 价格不同:

类型价格
生成 / 续写 / 翻唱 / 分轨(generate、extend、cover、stems 等 12 种)195 点/次(¥1.95)
拼接(concat)42 点/次(¥0.42)
替换片段(replace_section)270 点/次(¥2.70)
完整分轨(all_stems)690 点/次(¥6.90)

查询接口(query)不额外收费。

1 元 = 100 点。提交时按类型预扣,失败自动退回。

type 价格对照

请求 create 接口时,type 字段决定具体创作动作和计费规格。

type 参数值规格说明价格
generate生成音乐195 点/次
extend续写音乐195 点/次
upload_extend上传音频续写195 点/次
upload_cover上传音频翻唱195 点/次
concat拼接音频42 点/次
cover风格翻唱195 点/次
artist_consistency歌手风格生成195 点/次
artist_consistency_vox歌手风格人声生成195 点/次
stems基础分轨195 点/次
all_stems完整分轨690 点/次
replace_section替换片段270 点/次
underpainting添加伴奏195 点/次
overpainting添加人声195 点/次
remaster音质增强195 点/次
mashup混音融合195 点/次
samples添加采样195 点/次
inspo参考灵感生成195 点/次

业务参数

参数类型必填默认值可选值 / 范围示例说明
typestring否generategenerate / extend / upload_extend / upload_cover / concat / cover / artist_consistency / artist_consistency_vox / stems / all_stems / replace_section / underpainting / overpainting / remaster / mashup / samples / inspogenerate操作类型。generate 根据提示生成音乐;extend 基于已有音频续写;concat 拼接音频片段;cover 参考既有曲风重新演绎;upload_cover 对上传音频进行风格翻唱;upload_extend 续写上传音频;artist_consistency 按指定歌手风格生成;artist_consistency_vox 使用人声模式按歌手风格生成;stems 分离人声和伴奏;all_stems 分离人声、鼓、贝斯和其他乐器;replace_section 替换指定时间段;underpainting 为人声添加伴奏;overpainting 为伴奏添加人声;samples 在指定时间段添加采样;remaster 增强音质;mashup 混合多首歌曲;inspo 基于 1 到 4 段参考音频生成灵感作品。
promptstring否--A warm synth-pop song about city nights生成音乐的提示词。灵感模式下不超过 500 个字符;自定义歌词模式请优先使用 lyric 和 style。
lyricstring否---自定义模式下使用的歌词。常规模型最多 3000 字符,高质量模型最多 5000 字符。
stylestring否--dream pop, warm synth, mellow vocal音乐风格描述。常规模型最多 200 字符,高质量模型最多 1000 字符。
titlestring否--Neon Night自定义模式下的歌曲标题。常规模型最多 80 字符,高质量模型最多 100 字符。
customboolean否---是否启用自定义模式。请使用 JSON boolean;平台也兼容 true/false、1/0、yes/no、on/off 字符串。为 true 时按歌词和风格生成;为 false 时按提示词生成。
instrumentalboolean否---纯伴奏模式。请使用 JSON boolean;平台也兼容 true/false、1/0、yes/no、on/off 字符串。开启后将忽略歌词内容。
lyric_promptstring否---自动生成歌词的提示词,仅在 custom 为 true 且 lyric 为空时生效。
audio_idstring否---已有音频 ID。extend、concat 等基于已有音频的操作需要填写。
audio_urlsarray否--["https:\/\/example.com\/ref.mp3"]参考音频 URL 列表。inspo 类型要求 1 到 4 个可公开访问的音频地址。
persona_idstring否---歌手或声音风格 ID,用于让生成歌曲采用指定风格。
continue_atnumber否---从已有音频的指定秒数位置继续生成。例如 213.5 表示从 3 分 33.5 秒处续写。
vocal_genderstring否-m / f-人声性别偏好,m 表示男声,f 表示女声。该参数用于提高目标音色概率,但不保证严格符合。
style_negativestring否---不希望出现在音乐中的风格描述。
style_influencenumber否---风格影响强度,范围 0 到 1;数值越高越贴近填写的风格,仅在自定义模式下生效。
weirdnessnumber否---创意实验强度,范围 0 到 1;数值越高结果越开放,仅在自定义模式下生效。
audio_weightnumber否---参考音频权重,范围 0 到 1;数值越高越依赖参考音频,主要用于翻唱类操作。
variation_categorystring否-high / normal / subtle-变化强度,可选 high、normal、subtle。
mashup_audio_idsarray否---用于混合的音频 ID 列表。mashup 类型需要填写。
replace_section_startnumber否---replace_section 类型中需要替换片段的开始时间,单位秒。
replace_section_endnumber否---replace_section 类型中需要替换片段的结束时间,单位秒。
underpainting_startnumber否---添加伴奏的开始时间,单位秒,默认 0。
underpainting_endnumber否---添加伴奏的结束时间,单位秒,需小于歌曲总时长。
overpainting_startnumber否---添加人声的开始时间,单位秒,默认 0。
overpainting_endnumber否---添加人声的结束时间,单位秒,需小于歌曲总时长。
samples_startnumber否---添加采样的开始时间,单位秒,默认 0。
samples_endnumber否---添加采样的结束时间,单位秒,需小于歌曲总时长。
callback_urlstring否---任务完成或失败时由平台主动通知的 HTTPS 地址。

响应说明

提交成功后返回平台 task_id。请使用本应用查询接口或统一任务查询接口获取最终结果;如果请求传入 callback_url,平台会在任务终态时主动通知。

提交成功示例

{
    "code": 1,
    "msg": "success",
    "data": {
        "task_id": "task_xxxxxxxxxxxx",
        "status": "processing",
        "app": "music_generation",
        "api": "create",
        "frozen_points": 65,
        "actual_points": 0,
        "created_at": "2026-07-06T14:32:35Z"
    }
}

查询完成示例

{
    "code": 1,
    "msg": "success",
    "data": {
        "result": {
            "task_id": "task_xxxxxxxxxxxx",
            "status": "completed",
            "audio_url": "https://example.com/music/audio.mp3",
            "title": "Morning API",
            "data": [
                {
                    "id": "audio_xxxxxxxxxxxx",
                    "title": "Morning API",
                    "lyric": "[Verse]\nClean lines, clean run",
                    "style": "bright synth pop",
                    "duration": 20.5,
                    "audio_url": "https://example.com/music/audio.mp3"
                }
            ]
        },
        "usage": {
            "points_cost": 65,
            "actual_points": 65
        }
    }
}

失败示例

{
    "code": 0,
    "msg": "任务处理失败,请稍后重试",
    "data": null
}

音频地址说明

返回的 audio_url 形如 https://sunodownload.ai/suno/play?item_id=...,看着像播放页,实际直接返回 mp3 文件(Content-Type: audio/mpeg),可直接下载保存。

注意:data 数组里个别曲目的 audio_url 可能为空,遇到空值时取顶层 audio_url 或数组中第一个非空值。

同类文章