音乐生成
音乐生成应用:歌曲生成、歌词生成、参考音频、声音克隆,以及 MIDI / MP4 / WAV 导出与分轨处理。
所有接口 Base 为
https://api.a7w.cn/api/v1,请求头带Authorization: Bearer <API_KEY>与Content-Type: application/json;异步接口返回task_id,用查询接口轮询,或传callback_url等回调。
计费
按次固定扣费,不同 type 价格不同:
| 类型 | 价格 |
|---|---|
| 生成 / 续写 / 翻唱 / 分轨(generate、extend、cover、stems 等 12 种) | 195 点/次(¥1.95) |
| 拼接(concat) | 42 点/次(¥0.42) |
| 替换片段(replace_section) | 270 点/次(¥2.70) |
| 完整分轨(all_stems) | 690 点/次(¥6.90) |
查询接口(query)不额外收费。
1 元 = 100 点。提交时按类型预扣,失败自动退回。
接口一览
| 接口 | 方式 | 请求路径 | 调用模式 |
|---|---|---|---|
| [音乐生成 · 歌词混合](#/docs/music-generation-mashup-lyrics) | POST | /api/v1/apps/music_generation/mashup_lyrics | 同步 |
| [音乐生成 · 人声处理](#/docs/music-generation-vox) | POST | /api/v1/apps/music_generation/vox | 异步 |
| [音乐生成 · 优化音乐风格](#/docs/music-generation-style) | POST | /api/v1/apps/music_generation/style | 同步 |
| [音乐生成 · 导出 MIDI](#/docs/music-generation-midi) | POST | /api/v1/apps/music_generation/midi | 异步 |
| [音乐生成 · 歌词时间轴](#/docs/music-generation-timing) | POST | /api/v1/apps/music_generation/timing | 同步 |
| [音乐生成 · 导出 MP4](#/docs/music-generation-mp4) | POST | /api/v1/apps/music_generation/mp4 | 同步 |
| [音乐生成 · 导出 WAV](#/docs/music-generation-wav) | POST | /api/v1/apps/music_generation/wav | 异步 |
| [音乐生成 · 声音克隆](#/docs/music-generation-voice-clone) | POST | /api/v1/apps/music_generation/voice_clone | 同步 |
| [音乐生成 · 创建歌手风格](#/docs/music-generation-persona) | POST | /api/v1/apps/music_generation/persona | 同步 |
| [音乐生成 · 上传参考音频](#/docs/music-generation-upload-audio) | POST | /api/v1/apps/music_generation/upload_audio | 同步 |
| [音乐生成 · 生成歌词](#/docs/music-generation-lyrics) | POST | /api/v1/apps/music_generation/lyrics | 同步 |
| [音乐生成 · 查询音乐任务](#/docs/music-generation-query) | GET | /api/v1/apps/music_generation/query | 同步 |
| [音乐生成 · 创建音乐任务](#/docs/music-generation-create) | POST | /api/v1/apps/music_generation/create | 异步 |
详细文档
- [音乐生成 · 歌词混合](#/docs/music-generation-mashup-lyrics) — 将两段歌词融合为新的混合版本。
- [音乐生成 · 人声处理](#/docs/music-generation-vox) — 基于音频 ID 提取指定片段的人声或伴奏处理结果。
- [音乐生成 · 优化音乐风格](#/docs/music-generation-style) — 根据提示词生成更完整的音乐风格描述。
- [音乐生成 · 导出 MIDI](#/docs/music-generation-midi) — 基于音频 ID 提取 MIDI 文件。
- [音乐生成 · 歌词时间轴](#/docs/music-generation-timing) — 基于音频 ID 获取歌词与音频时间轴信息。
- [音乐生成 · 导出 MP4](#/docs/music-generation-mp4) — 基于音频 ID 获取视频文件链接。
- [音乐生成 · 导出 WAV](#/docs/music-generation-wav) — 基于音频 ID 导出高质量 WAV 文件。
- [音乐生成 · 声音克隆](#/docs/music-generation-voice-clone) — 基于清晰人声音频创建私有声音风格 ID。
- [音乐生成 · 创建歌手风格](#/docs/music-generation-persona) — 基于已生成歌曲创建可复用的歌手风格 ID。
- [音乐生成 · 上传参考音频](#/docs/music-generation-upload-audio) — 提交可访问的音频地址并返回可用于后续创作的音频 ID。
- [音乐生成 · 生成歌词](#/docs/music-generation-lyrics) — 根据主题或风格描述生成结构化歌词。
- [音乐生成 · 查询音乐任务](#/docs/music-generation-query) — 按平台任务 ID 查询任务状态与结果。
- [音乐生成 · 创建音乐任务](#/docs/music-generation-create) — 提交音乐生成、续写、翻唱、分轨或混音任务,返回平台任务 ID。
<!-- auto-generated:docs -->
音频地址说明
返回的 audio_url 形如 https://sunodownload.ai/suno/play?item_id=...,看着像播放页,实际直接返回 mp3 文件(Content-Type: audio/mpeg),可直接下载保存。
注意:
data数组里个别曲目的audio_url可能为空,遇到空值时取顶层audio_url或数组中第一个非空值。