外观
生成歌曲(灵感模式)
POST
https://www.aipro2.com/suno/submit/music等价于 POST /suno/submit/{action} 且 action=music(路由参数见 manifest)。
支持模型(mv):用户侧可复制 ID(与下方 examples 对齐;chirp-auk / chirp-fenix 仅为别名):
- chirp-v3-0(对应版本 v3.0)
- chirp-v3-5(对应版本 v3.5)
- chirp-v4(对应版本 v4.0)
- chirp-v4-5(对应版本 v4.5;别名 chirp-auk)
- chirp-v5(对应版本 v5.0)
- chirp-v5-5(对应版本 v5.5;别名 chirp-fenix)
- chirp-v6(对应版本 v6.0)
- chirp-v6-wild(对应版本 v6-wild)
- chirp-v6-mini(对应版本 v6-mini)
字段优先级:若同时提供 gpt_description_prompt 与 prompt,以网关/上游实际分支为准(勿当作简单二选一可同时填)。详见 API-Doc-Standards §2.3。
clip 续写:continue_clip_id 须来自先前 fetch 返回的 clip/song,不可自造。
接入步骤
A. 生成音乐
可以通过场生成歌曲接口生成后,获取其中的一首歌的 clip_id 值为: 54834687-5e79-4f08-8e14-cf188f15b598
B. 新建 Persona
clip_id需要系统内存在的,非 uploader- 不能跨账号,所以可能账号下线用不了
C. 使用 persona_id 创作
注意事项:
- mv 为
chirp-v3-5-tau或者chirp-v4-tau - task 为
artist_consistency - persona_id 为 B 步骤得到的
- artist_clip_id 就是 A 步骤中的
clip_id - 可跨账号
提交 AI 音乐创作任务,支持三种模式:
- 描述模式:填写
gpt_description_prompt,AI 自动生成音乐风格与歌词 - 自定义模式:填写
prompt(歌词)+tags(风格标签),精确控制创作方向 - 纯音乐模式:设置
make_instrumental: true,生成无歌词背景音乐 - 续写模式:填写
continue_clip_id+continue_at,延续已有片段
请求体参数
application/jsongpt_description_prompt*string创作描述 / 灵感提示词make_instrumental*boolean是否纯音乐默认值falsemv*string可选值chirp-v5-5chirp-v5chirp-v4-5+chirp-v4-5chirp-v4-5-allchirp-v4chirp-v3-5
响应
application/jsonSunoSubmitMusicResponse
code*string业务状态码data*string数据载荷(常为 Base64 或结构化对象)message*string提示信息
