> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# YuE2GenerateMusic - ComfyUI Built-in Node Documentation

> 从风格、歌词和 ABC 记谱生成音乐 token 和声学条件。

从风格、歌词和 ABC 记谱生成音乐 token 和声学条件。它返回条件以及生成的时长（秒），该时长应提供给 Empty YuE2 Latent Audio 节点。如果 ABC 输入留空，则忽略选定的模式，并自动使用 off 模式。

## 输入

| 参数                   | 描述                                          | 数据类型   | 必需 | 范围                       |
| -------------------- | ------------------------------------------- | ------ | -- | ------------------------ |
| `clip`               | 用于对音乐输入进行 token 化和编码的 CLIP 模型。              | CLIP   | 是  | -                        |
| `风格`                 | 描述音乐风格的文本。支持多行输入和动态提示词。                     | STRING | 是  | 多行文本                     |
| `歌词`                 | 生成音乐所用的歌词。支持多行输入和动态提示词。                     | STRING | 是  | 多行文本                     |
| `abc`                | 连接 ABC 生成器或提供编辑过的乐谱。留空以自动使用 off 模式。默认值：""   | STRING | 是  | 多行文本                     |
| `种子`                 | 用于生成的随机种子。默认值：0                             | INT    | 是  | 0 到 18446744073709551615 |
| `模式`                 | full：生成旋律和和弦；melody：仅生成旋律，推荐用于翻唱。默认值："full" | COMBO  | 是  | "full"<br />"melody"     |
| `max_duration`       | 最大时长（秒）。对于长提示词会自动缩短；生成可能会提前停止。默认值：360.0     | FLOAT  | 是  | 0.04 到 900.0             |
| `温度`                 | 用于生成的采样温度。默认值：1.0（高级）                       | FLOAT  | 是  | 0.0 到 5.0                |
| `top_p`              | 核采样概率阈值。默认值：0.95（高级）                        | FLOAT  | 是  | 0.01 到 1.0               |
| `top_k`              | Top-k 采样限制。默认值：100（高级）                      | INT    | 是  | 1 到 32768                |
| `repetition_penalty` | 应用于重复 token 的惩罚。默认值：1.2（高级）                 | FLOAT  | 是  | 0.01 到 10.0              |

注意：如果 `abc` 为空或仅包含空白字符，则忽略 `mode` 选择，并自动使用 off 模式。

## 输出

| 输出名称           | 描述                                            | 数据类型         |
| -------------- | --------------------------------------------- | ------------ |
| `CONDITIONING` | 从音乐 token 生成的声学条件。                            | CONDITIONING |
| `seconds`      | 生成的音频时长（秒）。将此值提供给 Empty YuE2 Latent Audio 节点。 | FLOAT        |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/YuE2GenerateMusic/zh.md)

***

**Source fingerprint (SHA-256):** `54f5d46cf083726bdf97c86e5683b2727840f75bb553bddf9525cfbf5affa44c`