aliyun/fun-music-v1
Fun-Music 端到端音乐生成(受邀测试):给一段风格描述即可生成完整音乐;做短剧 BGM 时传 is_instrumental=true 生成纯音乐。生成音频由网关转存永久 CDN 链接,按输出时长计费。
接口详情
POST
https://ai.codenews.cc/v1/music/generations请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| prompt | string | 是 | - | 音乐风格/情绪描述(prompt 与 lyrics 至少传一个),如“紧张悬疑的弦乐配乐,低沉大提琴” |
| lyrics | string | 否 | - | 自定义歌词(纯音乐模式忽略) |
| is_instrumental | boolean | 否 | false | true=纯音乐(无人声 BGM);false=带人声歌曲 |
| gender | string | 否 | - | 人声音色 male / female(纯音乐模式忽略) |
| format | string | 否 | mp3 | 输出格式 mp3 / wav |
| model | string | 否 | - | aliyun/fun-music-v1,不传按权重随机路由 |
代码示例
请将 $API_KEY 替换为您在控制台申请的真实 API Key。
响应示例
错误码
| 状态码 | 说明 |
|---|---|
| 401 | API Key 无效或缺失 |
| 400 | 参数错误,如 prompt/lyrics 均为空 / 不支持的模型 |
| 400 | 余额不足,请充值 |
| 400 | 内容命中敏感词 |
| 502 | 上游生成失败(Fun-Music 需开通邀测权限) |