Suno API 接口清单：一张表看清能调什么

接入方案先定接口边界：哪些动作产出新音频、哪些只是读取。前者计费，后者免费——这条线决定了成本结构。

三类接口一览

类型	包含	返回	计费
生成类	灵感模式、专业模式	一次 2 首	收费，默认 0.6 元/次
编辑类	翻唱、续写、替换段落、裁剪、删减、淡入淡出、倒放、变速、加伴奏、加人声、分轨、融合、采样、灵感	1 个新版本	收费
读取类	状态查询、歌曲列表、生成参数、余额、媒体地址、下载（MP3/WAV/视频/封面/歌词/MIDI）、时间轴歌词、分轨删除	数据或文件	免费

提交成功不等于生成完成。拿到歌曲 ID 之后按 3–5 秒一次轮询到完成，再取音频。一次生成返回 2 首，比较价格时应该算「每首多少钱」。

所有编辑动作都基于一首已完成的歌，产生一条新记录；原曲保持不变。所以改错了不用怕——换回原版本继续就好。常用组合是：翻唱换风格、替换段落改一句词、分轨后再单独处理某条轨。

状态、列表、参数、余额、下载地址与文件全部免费。唯一要记住的是下载地址会过期：过期后重新取一次即可，不需要重新生成，也不会再次计费。

按动作定：替换段落是选定区间，续写是从某时间点往后，分轨是把一首拆成多轨。

读取类没有生成开销，但仍有常规限流；生成类建议控制并发，不要瞬发几百个请求。

任务失败自动退费；注意不要因为「超时」而重复提交，那才会产生额外订单。

申请 Key、第一个请求、接口清单与报错排查
注册只需要邮箱，一次生成 0.6 元出 2 首，MP3 与 WAV 下载不限次。