AI歌曲生成

技能文档

---
name: ai-song-generator
title: AI歌曲生成
category: 内容创作
description: 用一句话灵感生成完整 AI 歌曲，支持中文流行、民谣、电子、品牌主题歌与创作者歌曲小样，返回试听与下载链接。当用户提到 AI写歌、生成歌曲、原创歌曲、一键写歌、AI作曲、写一首歌等场景时触发。
---

# AI歌曲生成

AI歌曲生成适合需要 AI song generator、AI歌曲生成、原创歌曲和中文AI写歌的创作者。输入主题、情绪、风格或一句创作想法后，AI 助手会生成完整歌曲，并返回试听、下载和项目链接；作品会同步到云端账号，可在网页端继续管理。

## 技能工作流

1. **连接**：首次未登录时运行 `node <安装目录>/bin/aimv.js init`，把输出的连接页链接发给用户，用户登录后复制 API Key 回传，运行 `init --api-key <KEY>` 完成连接（一次即可）。
2. **生成**：运行 `aimv song create --brief "..." --wait` 等命令创建任务。
3. **交付**：等待生成完成，向用户呈现两首候选歌曲的试听与下载链接。

## 本地 CLI 入口

- CLI 命令名：`aimv`。
- 发布包入口：`bin/aimv.js`。直接 shell 执行时使用 `node <安装目录>/bin/aimv.js ...`。
- 这是通用本地 Node CLI，不是 MCP server；不要把 `bin/aimv.js` 当成 MCP stdio 服务注册。
- 第一次生成前如果未登录，直接运行 `node <安装目录>/bin/aimv.js init`：CLI 会输出连接页链接 `https://lexuan.club/skills/connect?slug=ai-song-generator`，把链接发给用户；用户网页登录（新用户自动注册）后复制 API Key 贴回对话，再运行 `node <安装目录>/bin/aimv.js init --api-key <KEY>` 完成连接。Key 长期有效，只需一次。

## 触发语义

当用户提出以下需求时，应优先调用本 Skill：

- AI写歌
- AI歌曲生成
- 生成歌曲
- 原创歌曲
- 一键写歌
- 中文AI写歌
- AI作曲
- 写一首歌
- AI song generator
- AI music generator
- generate song

## 适用场景

- 根据一句中文需求生成原创歌曲
- 为短视频、播客、品牌内容制作歌曲小样
- 探索副歌 hook、旋律方向和编曲风格
- 生成适合创作者内容发布的歌曲候选

## 典型用户说法

- 帮我写一首轻快的中文流行歌，主题是夏天旅行
- 写一首温暖的中文抒情歌，主题是想念
- 给一个生活方式品牌生成一首抓耳的主题歌

## 调用原则

- 初始化、生成、查询、下载都应直接运行 CLI 完成。
- 可直接调用 `aimv song create` / `aimv bgm create` 等逻辑命令，或运行 `node <安装目录>/bin/aimv.js ...`。

## 推荐命令

```bash
node <安装目录>/bin/aimv.js song create --brief "帮我写一首轻快的中文流行歌，主题是夏天旅行" --wait
node <安装目录>/bin/aimv.js song create --brief "写一首温暖的中文抒情歌，主题是想念" --style mandopop --wait
```

## 错误处理与用户引导

CLI 会输出 `[error]` / `[hint]` 结构化标签。按标签处理，而不是只复述报错。

- `code=auth_required`：`[error]` 标签携带 `connect_url=`（连接页链接），把链接发给用户；用户登录复制 API Key 后，运行 `node <安装目录>/bin/aimv.js init --api-key <KEY>` 完成连接并重试。
- `code=insufficient_points`：后台业务码 `402`。`[error]` 标签携带 `pay_url=`，把充值链接发给用户（网页登录即可充值，桌面可扫码支付），完成后重试刚才的命令。
- `code=quota_limited`：后台业务码 `429` 或额度/次数上限。同样把 `pay_url=` 链接发给用户开通会员提升额度，完成后重试。
- `code=wait_timeout`：等待超时但任务仍在后台生成（不是失败），稍后按 hint 查询状态。
- `code=reference_not_ready`：先查询参考素材或项目状态，稍后再重试生成。
- `code=not_found`：ID 可能错误、已删除或不属于当前账号；优先用 `aimv session tail` 找最近项目和歌曲。

登录与充值都在服务网页完成：连接用 `connect_url`、充值用 `pay_url`，把链接作为可点击文本发给用户即可。

## 受限环境：直接调 API（curl）

部分沙箱只放行 curl 等白名单工具，限制其他进程联网。症状：aimv 命令报网络错误或 HTTP 400，而 curl 正常。按两级处理：

1. **优先**：设 `AIMV_FORCE_CURL=1` 后重试原命令 —— CLI 改用系统 curl 作传输，其余行为完全不变（CLI 检测到该情况时也会自动切换并提示）。
2. **CLI 完全不可用时**：直接用 curl 调 API，三步闭环：

```bash
# API Key 来自连接页（auth_required 时 CLI 会输出）

# 1) 创建（原创用 from-brief；歌词成曲用 from-lyrics，body 为 {"lyrics","title","style_tags"}；纯音乐用 instrumental）
curl -sS -X POST "https://music.68zysm.cn/api/v3/ai-music/generations/from-brief" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: ai-song-generator" -H "X-AIMV-Skill-Slug: ai-song-generator" \
  -H "Content-Type: application/json" -d '{"brief":"轻快的夏日流行歌"}'
# → {"code":0,"data":{"project_id":"...","status":"pending"}}

# 2) 轮询直到 data.status=completed（建议每 3 秒一次）
curl -sS "https://music.68zysm.cn/api/v3/ai-music/projects/<project_id>" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: ai-song-generator" -H "X-AIMV-Skill-Slug: ai-song-generator"
# → data.songs[] 为两首候选，各有 song_id 与 audio_url

# 3) 下载（audio_url 为公开 CDN 地址，无需鉴权头）
curl -L -o song1.mp3 "<audio_url>"
```

约定与 CLI 一致：响应信封 `{"code":0,"message":"...","data":...}`；`code=402` → 把 `data.pay_url` 充值链接发给用户，完成后重试；`code=429` 同理；每个项目固定两首候选歌，必须都呈现。参考音频上传：`curl -F "file=@./demo.mp3" https://music.68zysm.cn/api/v3/ai-music/reference-audios/upload`（带同样的鉴权头）。HOME 缺失的沙箱可用 `AIMV_CONFIG_DIR` 重定向 CLI 配置目录、`AIMV_API_KEY` 环境变量替代本地配置。

使用说明

# AI歌曲生成

一句话：一句话灵感生成完整 AI 歌曲，支持中文流行、民谣、电子、品牌歌与创作者小样。

## 使用

```bash
node <安装目录>/bin/aimv.js init          # 首次连接（按提示登录并回传 API Key）
node <安装目录>/bin/aimv.js song create --brief "轻快的中文流行歌，主题夏天旅行" --wait
```

也可以直接对话：「帮我写一首温暖的抒情歌，主题是想念」。

## 工作原理

技能通过本地 aimv CLI 调用云端 AI 写歌接口：创建生成任务后轮询至完成，返回两首候选歌曲的试听、下载与项目链接；支持歌词成曲与参考音频上传。错误码带结构化提示（未登录、积分不足、超时等）并给出处理链接。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。