API DOCUMENT

纯梦音乐生成 API

这里展示音乐生成、任务查询、歌词时间戳和参考音频上传接口的调用方式、参数和返回字段。

生成音乐

POST https://puream.cn/api/ai/suno/music/generate

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

变量名	类型	必填	变量简介
`gpt_description_prompt`	String	否	灵感模式提示词。描述歌曲主题、情绪和风格，系统自动生成歌词。与 prompt 二选一。
`prompt`	String	否	自定义歌词。用户已有歌词时使用。与 gpt_description_prompt 二选一。
`tags`	String	否	音乐风格标签，用英文逗号分隔，例如 Mandopop, warm, cinematic。
`negative_tags`	String	否	不希望出现的风格、声音或元素，例如 noise, distortion。
`mv`	String	是	模型版本。推荐 chirp-fenix；也支持 chirp-crow、chirp-bluejay、chirp-auk、chirp-v4 等。
`title`	String	是	歌曲标题。
`make_instrumental`	Boolean	是	是否生成纯音乐。true 为无歌词纯音乐，false 为带人声歌曲。
`task`	String	否	任务类型。不填为生成新歌；extend 为延长歌曲；cover 为翻唱。
`continue_clip_id`	String	否	延长歌曲时使用，填写查询接口返回的 custom_id。
`continue_at`	Number	否	延长歌曲起点秒数，例如 60。
`cover_clip_id`	String	否	翻唱时使用，填写原歌曲 custom_id。
`metadata`	Object	否	高级参数，例如 vocal_gender 和 control_sliders。普通用户不需要填写。

变量名	类型	变量简介
`task_ids`	Array<String>	生成音乐任务 ID 数组。通常一次返回两个任务 ID。
`error_message`	String	错误信息。成功时为空。

GET https://puream.cn/api/ai/suno/music/task?id=任务ID

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

变量名	类型	必填	变量简介
`id`	String	是	生成、上传或歌词时间戳接口返回的任务 ID。

变量名	类型	变量简介
`status`	String	任务状态。
`audio_url`	String	生成完成后的 MP3 音频地址。
`video_url`	String	生成完成后的 MP4 视频地址。
`image_url`	String	歌曲封面图片地址。
`duration`	Number	歌曲时长，单位秒。
`custom_id`	String	歌曲唯一 ID。歌词时间戳、延长、翻唱等后续操作使用它，不是任务 ID。
`title`	String	歌曲标题。
`error_message`	String	错误信息。成功时为空。

POST https://puream.cn/api/ai/suno/music/aligned-lyrics

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

变量名	类型	必填	变量简介
`lyrics`	String	是	完整歌词文本。
`suno_id`	String	是	歌曲 ID，即查询音乐任务返回的 custom_id。

变量名	类型	变量简介
`task_id`	String	异步任务 ID，后续用查询音乐任务接口轮询结果。
`error_message`	String	错误信息。成功时为空。

POST https://puream.cn/api/ai/suno/music/upload

名称	必填	说明
`Authorization`	是	`Bearer 你的纯梦 API Key`
`Content-Type`	是	`application/json`

变量名	类型	必填	变量简介
`audio_url`	String	是	公网可访问的参考音频 URL。

变量名	类型	变量简介
`task_id`	String	异步任务 ID，后续用查询音乐任务接口轮询结果。
`error_message`	String	错误信息。成功时为空。