Skip to main content
专属音乐模型可以从 6 至 24 首授权音频中学习一致的音乐特征，并用于后续歌曲创作。创建是异步操作；建议使用 24 首风格一致、音质清晰的音频获得更稳定的效果。
仅可提交您拥有合法使用权，或已取得模型创建及后续生成授权的音频。请勿上传未经许可的音乐或声音素材。

​
创建模型

调用 POST /suno/custom-models，并设置 action=create：
接口立即返回平台模型 ID 和任务 ID。创建完成后，回调或查询结果中的 status 会变为 ready。只有模型创建成功才会计费 10 Credits；创建失败不会扣费。

​
查询模型

查询单个模型：
分页查询当前应用的模型：
所有模型均归属于创建它的 Suno 应用。API 凭据轮换不会改变模型归属，其他应用不能查询或使用该模型。

​
使用模型生成歌曲

模型状态为 ready 后，继续调用 POST /suno/custom-models，并设置 action=generate：
id 必须是当前应用下状态为 ready 的专属音乐模型。模型不可用时请求会失败，不会自动改用其他模型。persona_id 与专属音乐模型互斥；同时提交时接口会在请求发送到生成服务前返回 HTTP 400，且不会扣费。如需使用 Persona，请改用 /suno/audios 的 artist_consistency 或 artist_consistency_vox 操作。 歌曲生成成功消耗 0.90 Credits；生成失败不扣费。查询和归档模型免费。

​
归档模型

当前 Beta 版本会将模型归档并禁止继续使用，响应中的 capacity_released=false 表示归档不承诺释放模型容量。归档操作可重复调用，不会重复计费。