无限API

创建音乐

接口: POST https://infai.cc/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)
  • acemusic-v1.1(ACE Music v1.1 Preview,推荐)
  • acemusic-v1(ACE Music v1)
  • ace-step-1.5-xl(ACE-Step v1.5 XL)

ACE 版本:mv 填 ACE 版本号即切到 ACE 音乐模型(网关自动带上游 expectAiModel=ace,无需额外参数),其余参数与 Suno 相同,价格与 Suno 相同。 ACE 支持灵感模式、自定义模式、翻唱;翻唱流行歌曲 / 已在 Suno 库里的歌不会被 Suno 版权拦截。 翻唱:cover_clip_id 直接填音频 URL(推荐),或填先用 POST /suno/uploads/audio(带 expect_ai_model: ace)上传参考音频后得到的 so_ 开头 ID。 自定义模式可选 negative_tags(不想要的风格)。MIDI 创作是 Suno 专属,不能和 ACE 版本一起用(会返回 400)。

字段优先级:若同时提供 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,延续已有片段
  • MIDI 创作:灵感模式 + metadata_params.midi_id(MIDI 文件网址),按 MIDI 旋律创作

本接口在模型广场和消费记录中显示为 suno_music_open。

MIDI 创作(Open 渠道)

上传一段 MIDI 旋律,AI 按旋律创作歌曲:MIDI 决定弹什么音,gpt_description_prompt 决定风格、乐器和演奏方式(如「改编成弦乐四重奏,严格按 MIDI 的音符与和弦演奏」)。

  • metadata_params.midi_id 填 可公开访问的 .mid / .midi 文件网址(http/https),由上游下载;API 不提供文件上传,请自行托管文件。值为 null 或空字符串时视为未传。

  • 只支持灵感模式:必须填 gpt_description_prompt;不能同时带 prompt(歌词)、task、continue_clip_id、cover_clip_id,否则返回 400。

  • 模型固定为 chirp-v6-wild(Suno 官方限制):mv 不传或传其它版本都会被网关改为 chirp-v6-wild。

  • 计费与普通创作相同;查询结果方式不变(POST /suno/fetch)。

请求体 (application/json)

  • gpt_description_prompt (string, 必填): 创作描述 / 灵感提示词
  • make_instrumental (boolean, 必填): 是否纯音乐
  • mv (string, 必填) ["chirp-v5-5", "chirp-v5", "chirp-v4-5+", "chirp-v4-5", "chirp-v4-5-all", "chirp-v4", "chirp-v3-5", "chirp-v6", "chirp-v6-wild", "chirp-v6-mini", "acemusic-v1.1", "acemusic-v1", "ace-step-1.5-xl"]
  • cover_clip_id (string): 翻唱的源音频。ACE 版本可直接填音频 URL,或填 POST /suno/uploads/audio(带 expect_ai_model=ace)上传后得到的 so_ 开头 ID
  • expect_ai_model (string): 指定上游模型,只接受 ace。通常不用填:mv 填 ACE 版本时网关自动带上 ["ace"]
  • metadata_params (object): 扩展参数;MIDI 创作时填 midi_id
  • negative_tags (string): 自定义模式下不想要的风格标签(可选,ACE 版本支持)

请求示例

{
  "gpt_description_prompt": "一首轻快的夏日流行歌",
  "make_instrumental": false,
  "mv": "acemusic-v1.1"
}