Extensions/YinChao Music
ComfyUI Extension

YinChao Music

YinChao Music provides ComfyUI V3 nodes for lyric generation, prompt-to-song generation, reference-based generation, and song extension via the YinChao API. Results are decoded to native AUDIO for direct use in audio, video, and subtitle workflows.

By yinhcao·Created 28 days ago·Updated 27 days ago· 17
yinhcao/ComfyUI-YinChao
Nodes4
On cloudLocal install
CategoryYinChao/Music
Stars17
Updated27 days ago

Nodes (4)

YinChao Extend Music

Finished Too Soon? Extend Any AUDIO Into a Longer Song

YinChao/Music
YinChao Generate Lyrics

Write the Lyrics Before You Pay for the Song

YinChao/Music
YinChao Generate Music

Prompt to Song, Zero GPU, Native AUDIO Out

YinChao/Music
YinChao Reference Music

Style-Clone Any Clip

YinChao/Music
Readme

YinChao Music for ComfyUI

English

🎵 音潮音乐大模型 V4.0 重磅上线！

音乐生成低至 ¥0.22/首，现在申请即可获得限时免费名额。

立即申请免费名额

音潮音乐节点（ComfyUI V3）。插件把音潮开放平台的歌词、生歌、仿写和扩写能力接入 ComfyUI，并将生成结果转换成原生 AUDIO，可以继续连接音频、视频和字幕节点。

安装

ComfyUI Manager / Registry

在 ComfyUI Manager 中搜索 YinChao Music，找到节点后点击安装，重启 ComfyUI 即可使用。

手动安装

将仓库目录放到：

ComfyUI/custom_nodes/yinchao-music/

在 ComfyUI 使用的 Python 环境中安装依赖，然后重启 ComfyUI：

python -m pip install -r requirements.txt

av 是 Python 音频编解码依赖。用户不需要自行安装系统 ffmpeg 命令；插件不会要求手动下载或配置系统编解码器。

配置 API Key

  1. 打开 音潮开放平台，注册或登录。
  2. 申请限时免费名额，或完成账户充值。
  3. 创建音潮 API Key。
  4. 在 ComfyUI 的 Settings → YinChao → API Key 中填写密钥并保存。

密钥不会作为节点输入，也不会写入 Workflow JSON。无图形界面时可以使用环境变量：

export YINCHAO_API_KEY="your-api-key"

配置优先级是 ComfyUI 用户设置、本地用户配置文件、YINCHAO_API_KEY 环境变量。缺少密钥、密钥无效、余额不足、参数错误、内容审核失败、任务失败和超时都会以明确错误中止节点，不会返回空字符串假装成功。

插件调用的 API 地址是 https://open.yinchaoyongxian.com；上面的平台地址用于注册、充值和创建 API Key。

四个节点

| 节点 | 输入 | 输出 | | --- | --- | --- | | YinChao Generate Lyrics | Prompt | title, lyrics | | YinChao Generate Music | model（默认 v4.0）、prompt、可选歌词 | native AUDIO, title, lyric, audio_url, task_id | | YinChao Reference Music | native AUDIO、similarity、可选 prompt/歌词 | native AUDIO, title, lyric, audio_url, task_id | | YinChao Extend Music | native AUDIO、可选起始秒数/歌词 | native AUDIO, title, lyric, audio_url, task_id |

每次歌曲类节点执行固定提交 n=1，避免平台默认 n=2 导致一次执行生成两首并产生双倍费用。节点内部负责提交异步任务、轮询任务状态、下载 MP3 并解码；用户不需要再拼接 submit/wait/download/convert 节点。

Reference Music 和 Extend Music 会把输入的 native AUDIO 自动编码为 MP3 后上传。上传限制按音潮接口的 10 MB 执行；超限会明确报错，不会悄悄改变输入质量。生成结果只解码为 native AUDIO，不会为了输出再次压缩。

官方组合 Workflow

仓库提供 5 个示例：

  1. workflows/lyrics_to_music.json：歌词生成 → 生歌（官方组合）
  2. workflows/lyrics_example.json：独立歌词生成
  3. workflows/music_example.json：独立提示词生歌
  4. workflows/reference_example.json：独立仿写
  5. workflows/extend_example.json：独立扩写

组合 Workflow 只连接歌词文本，不包含 API Key。导入后先配置设置，再执行会产生平台费用的歌曲节点。

API 与计费提示

当前适配的 API 路径：

  • POST /api/v1/lyric/generate：独立歌词生成；
  • POST /api/v1/song/generate：normal 生歌或 reference 仿写；
  • POST /api/v1/song/extend：扩写；
  • POST /api/v1/file/upload：上传参考或原始音频；
  • GET /api/v1/task/query：查询异步任务。

歌曲类调用按平台实际账户规则计费；文档当前标注生歌、仿写、扩写约 ¥0.22/首，独立歌词约 ¥0.07/次。请以平台账户和最新文档为准。

开发验证

本仓库测试不调用真实 API，也不会消耗账户额度：

python3 -m unittest discover -s tests -p 'test_*.py'
python3 -m compileall -q yinchao_music tests
node --check js/settings.js
git diff --check

节点使用 comfy_api.latest 的 V3 schema，不保留旧版 NODE_CLASS_MAPPINGS 或旧节点输入兼容层。实际运行前需要在目标 ComfyUI 安装中做一次真实的“配置 Key → 执行测试 Workflow → 检查 AUDIO 输出”验收；本仓库的离线测试不会替代这一步。

相关文档

许可证

本项目使用 MIT License。