AI 音乐工坊 · 一句话出一首歌

给一句话，拿走一首完整的歌——有人声、有伴奏、有歌词、能下载。

不用懂乐理，不用买音源，不用装宿主软件，也不用自己部署 GPU。 一台能跑 curl 的机器 + 一个 api.a7w.cn 的 Key，就够了。

一、一首歌，到底花多少钱

平台按点数计费，1 元 = 100 点。这个插件 13 个接口的租户实际结算价：

三种典型花法：

lyrics 一趟拿两样：它返回的 tags 里直接带一段专业编曲描述， 可以当 style 用 —— 所以走 lyrics 就不用再单独调 style，省 0.14 元。 详见 references/api-lyrics.md。

⚠️ 平台同时给出标准价和租户实际结算价，两者可能差很多。 上表是租户实际结算价；以你账号里实际扣费为准 （每次返回的 data.usage.points_cost 就是本次真实扣费，可以直接对账）。 查询类接口（query / timing）免费，可以放心轮询。

一·五、先看一个真实输出

下面全部是实际调用的结果，不是示例编的。输入就一句话：

写一首关于凌晨加班后骑车回家的城市民谣，主歌写疲惫，副歌写希望

8.5 秒后返回，AI 自己起了标题 《夜归单车》，歌词是完整的 Verse / Pre-Chorus / Chorus / Verse 2 / Bridge 结构：

[Verse 1]
楼下的风有点冷
我把领子竖了又竖
工牌还挂在胸口
像一天没卸下的负重

[Chorus]
我骑回家
天就快亮了
心里那点火
还没有熄呢

同一次返回里，还附了一段可以直接用的专业编曲描述：

City folk with gentle fingerpicked acoustic guitar, brushed percussion, and a
steady walking bass; verse feels weary and close-mic with sparse room tone,
pre-chorus lifts on layered harmonies and rising strings, chorus opens warm
and singable with gang-vocal echoes on the anchor phrase. Add a soft tape hiss,
passing-bus ambience between lines...

这段填进 create 的 style，就是上一节说的"省掉 0.14 元"。 扣费 usage.points_cost = 12，与价目表完全一致。

完整请求与返回结构见 references/api-lyrics.md。

二、两种创作模式，别用错

create 的核心开关是 custom：

歌词与风格的字符上限随模型变：

custom: true 且 lyric 为空时，才轮到 lyric_prompt 生效（AI 按你的主题自动写词）。

三、17 种生成操作，一张表看懂

create 的 type 参数决定干什么。同一个接口，17 种玩法：

从零创作

续写与拼接

编辑与增强

分轨

四、13 个接口一览

逐接口的完整参数表见 references/。

五、⚠️ 用之前：先拿一个 Key，否则跑不起来

本 Skill 不内嵌任何密钥，也不代付费用。 必须有一个 api.a7w.cn 的 API Key。

第一步：注册并创建 Key

1. 打开 算力集市 api.a7w.cn 注册（新用户有赠送点数，可以先白跑几条试试）
2. 在控制台创建一个 API Key，形如 sk-xxxxxxxx...
3. 完整复制保存 —— 多数平台只在创建时显示一次

第二步：把 Key 填进你正在用的地方

读取顺序：--key 参数 → 环境变量 A7W_API_KEY → ~/.a7w/config.json

不用这个 Key 也完全没关系——换任何一家的音乐 API，成本都不会是 0.65 元一首。

六、怎么调用

零安装用法（推荐先看这个）

本 Skill 自带一个只用 Python 标准库的客户端，不需要装任何第三方包：

# 1. 配置你自己的 API Key（只需一次）
export A7W_API_KEY=sk-你的key

# 2. 看这个插件的接口与参数
python3 scripts/a7w.py schema music_generation

# 3. 生成一首歌（异步任务，客户端会自动轮询到结束）
python3 scripts/a7w.py call music_generation create \
  --body '{"type":"generate","prompt":"一首轻快的城市清晨民谣，木吉他，男声","custom":false}'

直接 curl

# 提交生成任务
curl -sS -X POST "https://api.a7w.cn/api/v1/apps/music_generation/create" \
  -H "Authorization: Bearer $A7W_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"generate","prompt":"一首轻快的城市清晨民谣，木吉他，男声","custom":false}'

# 拿返回的 task_id 查结果
curl -sS -X POST "https://api.a7w.cn/api/v1/apps/music_generation/query" \
  -H "Authorization: Bearer $A7W_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task_id":"<上一步返回的 task_id>"}'

同步 vs 异步

a7w.py call 默认自动轮询到结束；加 --no-wait 只提交不等。

七、从想法到成品：完整一条流水线

目标：一首有词、有曲、无损、带字幕时间轴的歌。

KEY=sk-你的key
API=https://api.a7w.cn/api/v1/apps/music_generation

# ① 写词（0.12 元）—— 也可以自己写，跳过这步
curl -sS -X POST "$API/lyrics" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"写一首关于凌晨加班后骑车回家的城市民谣，副歌要有希望感"}'

# ② 把风格描述优化得更专业（0.14 元）—— 可选，但对效果提升明显
curl -sS -X POST "$API/style" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"城市民谣，木吉他，温暖男声，慢速"}'

# ③ 生成（0.65 元）—— custom=true 时用你给的词和风格
curl -sS -X POST "$API/create" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type":"generate",
    "custom":true,
    "title":"凌晨两点的环路",
    "lyric":"<第①步的歌词>",
    "style":"<第②步优化后的风格>",
    "vocal_gender":"m",
    "weirdness":0.3,
    "style_influence":0.7,
    "style_negative":"电子, 说唱"
  }'
# → 记下返回的 task_id

# ④ 查结果（免费）
curl -sS -X POST "$API/query" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"task_id":"<task_id>"}'

# ⑤ 导出无损 WAV（0.14 元）
curl -sS -X POST "$API/wav" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"audio_id":"<结果里的 audio_id>"}'

# ⑥ 拿歌词时间轴做字幕（免费）
curl -sS -X POST "$API/timing" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"audio_id":"<audio_id>"}'

想让 AI 用你自己的音色唱：

# 克隆音色（0.20 元，只需做一次，之后可复用）
# audio_url 要公网可访问的 MP3/WAV，至少 10 秒、单人清晰人声、尽量无背景噪音
curl -sS -X POST "$API/voice_clone" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url":"https://你的存储/我的清唱.mp3","name":"我的声音"}'
# → 拿到 persona_id / 声音风格 ID，之后在 create 里带上 persona_id

想拿现成伴奏练唱 / 二次创作：

# 分离人声与伴奏（0.65 元）
curl -sS -X POST "$API/create" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"stems","audio_id":"<已有音频的 audio_id>"}'

# 四轨全分（人声 / 鼓 / 贝斯 / 其他）
curl -sS -X POST "$API/create" -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"all_stems","audio_id":"<audio_id>"}'

八、常见坑

九、权限与用途说明

不内嵌任何密钥。 请求只发往 api.a7w.cn，不发送到其他任何地址。

十、能力边界

• 不提供 API Key：Key 必须由使用者自己获取
• 不代付费用：调用消耗的是使用者自己账号的点数
• 不保证可用性：接口由平台弹性调度，可用性、限流与计费以站内为准
• 不替代版权审查：生成内容的使用与合规责任由使用者承担。做 AI 翻唱、续写、分轨时，请确认你对原始音频有相应权利
• 不做声音仿冒：克隆他人音色用于冒充、诈骗或误导，属于违法用途

参考文件

联系我们

• 技术微信：9872659 —— 加好友时说一下是从哪个 Skill 找过来的，直接给你配套的 API Key 与能跑的示例。
• 要算力 / 要 API Key：算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力，注册、充值、创建 Key 都在这里。
• 更多 AI 插件与接口：AI 插件市场。

相关链接