Suno 音乐台 一句话出一首歌

先申请你自己的 API Key:本包不内嵌任何 Key,用的是你自己在
api.a7w.cn 注册的 Key,扣的是你自己账户的余额。
登录:python3 scripts/a7w.py login --key sk-你的key

一句话

给人一句话,它给你一首完整的歌。 走 api.a7w.cn 的 media_services_33,7 个 Suno 音乐接口一个命令一个,异步提交 + 自动轮询,零依赖。

能干什么

能力一条具体用法你会拿到
出歌song --prompt "夏夜霓虹的温暖合成器流行"一首完整歌:人声 + 伴奏 + 歌名
写词出歌song --custom --style "dream pop" --lyrics "[主歌]…" --title 夜行歌词严格照唱,风格按你的标签走
纯音乐song --prompt "钢琴独白" --instrumental无人声的伴奏曲
延长extend --audio-id <audio_id> --lyrics "…"在原曲后面再接一段
音效sound --prompt "雨打铁皮棚,远处闷雷" --tempo 90 --loop一段可循环的音效
自建音色voice --action prepare --voice-url <样本> --start 3 --end 18验证短句 → create 出你的音色
时间戳歌词lyrics --task-id <id> --audio-id <id>逐句时间轴,直接压字幕
恢复recover --task-id <id>链接过期后把音频再取一次
Personapersona --name 夜行嗓 --task-id <id> --audio-id <id> --description "…"可复用的风格模板

怎么串起来

写词  →  出歌  →  不满意就延长  →  要字幕就取时间戳歌词  →  要自己的声音就建音色
python3 scripts/run.py song   --custom --style "city pop" --lyrics "[主歌]霓虹把街角点亮" \
    --title "夜行" --yes
# 完成时会打印 audio_id,记下来
python3 scripts/run.py extend --audio-id <audio_id> --lyrics "…" --yes
python3 scripts/run.py lyrics --task-id <task_id> --audio-id <audio_id> --yes
python3 scripts/run.py voice  --action prepare --voice-url https://…/me.wav --start 3 --end 18 --yes

--no-wait 只提交拿 task_id 就走,之后 task --task-id … 免费续查,同一条结果不会重复提交。

价格口径(诚实版)

/api/v1/pricing 里没有 media_services_33 的专属规则,落通配:

上游真实点数要真跑一条才看得到,所以 cost 给的是下限估算,不是报价:

python3 scripts/run.py cost                      # 未知上游 → 至少 50 点(¥0.50)
python3 scripts/run.py cost --upstream 65        # 你观察到的上游 65 点 → 130 点(¥1.30)
python3 scripts/run.py cost --upstream 65 --tasks 3

三步上手

# 1) 自检(不扣费):Key、应用、7 个端点、任务查询
python3 scripts/run.py doctor

# 2) 先看价:给的是下限
python3 scripts/run.py cost --tasks 1

# 3) 出歌
python3 scripts/run.py song --prompt "夏夜霓虹的温暖合成器流行" --yes

缺 --yes 退 4 并告诉你下限是多少;下限超 --budget 退 5,一个请求都不发。
想先看不花钱的请求:song --prompt "…" --dry-run。

子命令

子命令计费干什么
catalog免费现查 7 个接口的必填项与 model 枚举
doctor免费自检 Key / 应用 / 7 个端点 / 任务查询
cost免费先算钱(下限)
song上游×2 保底 50 点生成音乐
extend同上延长音乐
sound同上生成音效
voice同上自建音色(prepare → create)
lyrics同上带时间戳歌词
recover同上恢复音频
persona同上生成 Persona
task免费查状态 / 补取结果
log免费本地台账

关键参数

参数说明
--modelV6(默认)/ V6_MINI / V6_WILD / V5_5 / V5 / V4_5ALL / V4_5PLUS / V4_5 / V4;sound 只收 V5/V5_5/V6 系
--budget点数上限,单位是点(1 元 = 100 点),默认 500
--upstream你观察到的上游点数,用来把下限换算成实际价
--out DIR顺手把音频下载到本地

退出码

码含义
0成功
2用法错(缺必填、model 不在枚举、数值越界)
3doctor 有检查项没过
4没有 --yes
5下限超 --budget,一个请求都不发
6调用失败 / 任务失败 / 轮询超时
1内部错误
130被 Ctrl-C 中断

--json 契约

{"ok": true, "api": "music_generate", "task_id": "task_xxx", "status": "completed",
 "audios": [{"audio_id": "audio_xxx", "audio_url": "https://…", "title": "夜行"}],
 "pointsFloor": 50, "usage": {"points_cost": 65}}

失败:{"ok": false, "exit": 5, "error": {"kind": "budget", "message": "…"}}。
--json 写在子命令前后都可以,stdout 只有一个 JSON 文档。

文件结构

sanjianke-suno-music/
├── SKILL.md
├── README.md
├── LICENSE.md
├── references/
│   ├── api-contract.md       接口契约(schema 原文 + 实测)
│   └── troubleshooting.md    排错:按报错找原因
└── scripts/
    ├── a7w.py                零依赖客户端(全家族共用,逐字节一致)
    └── run.py                本包命令层

联系我们

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

同类文章