Song Generator 是一个 ComfyUI 工作流，使用 Ace-Step 1.5XL 音频模型合成完整歌曲。它支持两种歌词路径：自动模式（输入简短主题，扩展为包含 BPM 与时长约束的歌词）与手动模式（粘贴你自己的文本）。ComfySwitchNode 在两条路径之间进行路由，随后歌词由 TextEncodeAceStepAudio1.5 编码，并用于引导音频模型。你可以用 PreviewAny 试听结果，并用 SaveAudioAdvanced 导出。
在底层，UNETLoader 与 VAELoader 加载 Ace-Step 1.5XL 的 checkpoints。EmptyAceStep1.5LatentAudio 会按目标时长分配潜空间音频画布。ModelSamplingAuraFlow 配置该模型的采样器，KSampler 则使用 TextEncodeAceStepAudio1.5 生成的条件对潜空间进行迭代去噪。ConditioningZeroOut 用于在未使用时安全地将可选的负向条件清零。采样完成后，VAEDecodeAudio 将潜空间转换为波形，以便监听与导出。
歌词模块（感知 BPM/时长）通过 PrimitiveInt/PrimitiveFloat 记录 BPM 与目标长度，用 StringReplace 将这些值注入写歌指令，再用 TextGenerate 生成符合曲长的结构化主歌/副歌。StringCompare 用于检测空输入，ComfySwitchNode 则在自动歌词与用于手动输入的 PrimitiveStringMultiline 节点之间进行选择。DualCLIPLoader/CLIPLoader 也可用于可选地混入 CLIP 风格的文本条件，不过主路径使用的是 TextEncodeAceStepAudio1.5 来适配 Ace-Step。
API
通过代码使用此工作流
每个 Comfy 工作流都是一个 JSON 图。下面的内容就是此工作流的完整数据，ComfyUI 运行时也是如此——你可以从该 URL 获取、放入版本控制，或在 ComfyUI 中加载并逐节点运行。
使用 Comfy SDK 从 TypeScript 或 Python 运行。相同代码可用于 Comfy Cloud 或你自托管的 ComfyUI——只需更改基础 URL。
// Install (beta)
npm i @comfyorg/sdk
// Run this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");SDK 需要 API 格式的工作流：在 ComfyUI 中打开此工作流，使用 文件 → 导出工作流（API）。
常见问题
