众扬汇 AI 开放平台 API 文档

音乐版本以及生成参数介绍

Suno 版本介绍

提交任务时通过 mv 参数指定要使用的 Suno 版本:

text
{
    "prompt": "",
    "mv": "chirp-v4"
}

各版本与 mv 取值的对应关系如下(各版本在我方平台的实际上架情况,请以「模型广场」为准):

版本 mv 上线时间 prompt 限制 tag 限制 歌曲最长时长
v5.5 chirp-fenix 2026.03.27 5000 1000 8 分钟
v5 chirp-crow 2025.09.23 5000 1000 8 分钟
v4.5+ chirp-bluejay 2025.07.17 5000 1000 8 分钟
v4.5-all chirp-auk-turbo 2025.05.03 5000 1000 4 分钟
v4.5 chirp-auk 2025.05.03 5000 1000 4 分钟
v4 chirp-v4 2024.12.17 3000 200 150 秒
v3.5 chirp-v3-5 已下线 3000 200 120 秒
v3.0 chirp-v3.0 已下线 3000 200 120 秒

表中“上线时间”仅作版本发布节奏的参考;prompt 与 tag 的字数上限、时长上限请以实际接口返回为准。

自定义创作模式

自定义创作有三条提交路径,下面三张表分别是它们的参数清单,字段名与接口保持一致。

普通生成

参数名 类型 描述 备注
title String 作品标题
tags String 风格标签,多个用半角逗号分隔
generation_type String 生成方式标识 默认 TEXT
prompt String 创作提示词,可包含歌词
negative_tags String 需要排除的风格 允许为空字符串
mv String 指定模型版本 默认 chirp-v4,可选 chirp-v3-5、chirp-v3-0,非必填。扩展上传的音频时使用 chirp-v3-5-upload

续写

参数名 类型 描述 备注
task_id String 要续写的前置任务 id
title String 作品标题
tags String 风格标签,多个用半角逗号分隔
generation_type String 生成方式标识 默认 TEXT
prompt String 创作提示词,可包含歌词
negative_tags String 需要排除的风格 允许为空字符串
mv String 指定模型版本 默认 chirp-v4,可选 chirp-v3-5、chirp-v3-0
continue_at Float 续写起点 从第几秒开始继续创作,例如 120.00 或 61.59
continue_clip_id String 待续写作品的 id
task String 任务类型 默认为 extend

上传生成

参数名 类型 描述 备注
prompt String 创作提示词 允许为空字符串
generation_type String 生成方式标识 默认 TEXT
tags String 风格标签 多个用半角逗号分隔
negative_tags String 需要排除的风格 允许为空字符串
mv String 指定模型版本 请使用 chirp-v3-5-tau
title String 作品标题
continue_clip_id String 待续写作品的 id 非必传,可为 null
continue_at Float 续写起点(秒) 非必传,可为 null
continued_aligned_prompt String 续写对齐提示词 非必传,可为 null
infill_start_s Float 填充起点(秒) 非必传,可为 null
infill_end_s Float 填充终点(秒) 非必传,可为 null
task String 任务类型 使用 Cover 功能时填 cover
cover_clip_id String 翻唱源曲 id,或上传音频的 clip id 用于 Cover 功能
task_id String 要续写的前置任务 id