Skip to main content
POST
创建模型是异步任务。提交后先取得训练 task_id,轮询任务完成后再从 data.result.model_id 读取自定义模型 ID。

Authorizations

string
必填
Bearer Token。访问 API Key 管理页面 获取 API Key。

Body

string
默认值:"suno"
固定使用 suno
string
必填
自定义模型名称。去掉首尾空白后不能为空。
string[]
必填
6–24 条公网可访问的 HTTP(S) 音频直链,建议使用 MP3、WAV 或 M4A。每条 URL 都应直接返回音频文件,不能是需要登录的网页。
无效素材可能导致整个创建任务失败。本地文件请先使用项目的上传能力获得公网 URL;不要传本地路径或 blob: URL。

Response

integer
响应状态码。
array
提交结果。读取 data[0].task_id,再通过 GET /v1/music/tasks/{task_id} 查询训练状态。

使用创建的模型

完成后保存 result.model_id,后续在支持自定义模型的操作中作为 custom_model_id 使用,并省略 versionpersona_id
创建模型可能需要数分钟,最长约 20 分钟。自定义模型的实际可用时间可能变化,界面不应承诺固定的精确到期时间。创建模型与后续每次生成分别计费。