在用户录制验证短句后,生成 Suno Voice 自建音色。提交原验证任务 ID、用户朗读验证短句后的音频 URL,以及可选的音色元信息,例如 voice_name、description 和 style。系统会验证录音并创建可复用的自建音色。为了获得更佳效果,请上传或录制一段歌声样本。纯净的清唱人声通常能生成最准确的人声分析结果。查询任务状态#
生产环境中,建议使用 callBackUrl 参数在自建音色生成完成后接收自动通知。
使用生成的音色#
获取 Voice ID:Voice ID 就是验证短句任务的 taskId,create-voice 也会在 resultJson.resultUrls[0] 中返回它。调用“检查音色是否可用”接口时,task_id 也填这个 Voice ID,不要填 create-voice 任务自身的 taskId。create-voice 会立即返回 success,这只表示请求已受理。验证短句任务的状态变为 "success"(通常一分钟内)即表示音色已可用;变为 "fail" 表示录音未通过校验。可在验证短句任务的 callBackUrl 接收结果(data.status 为 "success" 或 "fail"),或用该 taskId 轮询查询任务详情。使用时,在生成音乐接口中把 Voice ID 填入 persona_id,并设置 persona_model: "voice_persona"。