%20(1).png)
1. 插件简介
ComfyUI-LumaAPI 是一个连接 Luma 实验室服务的桥梁插件，让你能在 ComfyUI 里直接制作电影级别的视频。这个插件主要用于学习目的，能够帮你把文字描述变成真实的视频。
插件原地址： https://github.com/superyoman/comfyui_lumaAPI
主要功能： - 把你的文字描述变成视频（就像魔法一样） - 自动下载生成的视频到你的电脑 - 提供视频链接方便分享 - 支持检查视频制作进度
2. 如何安装
方法一：手动安装
- 打开你的 ComfyUI 文件夹
- 进入
custom_nodes文件夹 - 在命令行输入：
git clone https://github.com/superyoman/comfyui_lumaAPI.git - 如果需要，运行：
pip install -r requirements.txt - 重启 ComfyUI
方法二：ComfyUI 管理器
- 打开 ComfyUI
- 点击 "Manager"
- 搜索 "lumaAPI"
- 点击安装并重启
必要设置
- 需要访问 https://lumalabs.ai/ 并登录
- 使用浏览器开发者工具（F12）获取网络请求信息
- 把获取到的 cookie 信息复制到 key.json 文件中
3. 节点详细解析
3.1 LUMA_API_YoC 节点（视频生成器）
这个节点就像一个神奇的视频制作机，你输入文字描述，它就能给你生成对应的视频。想象一下，你告诉机器"一只猫在雨中跳舞"，它就能真的给你做出这样的视频！
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文字描述 | text | 字符串 | 简洁明确的描述 | 就像给画家下订单一样，你说你想要什么样的视频 | 用于指导视频生成的文本提示词 | 输入"一只橙猫在花园里追蝴蝶"，系统就会生成相应视频 |
| 下载到本地 | download | True/False | True | 决定视频做好后要不要自动保存到你电脑里 | 控制是否将生成的视频下载到本地存储 | 设置为True，视频会自动保存到output文件夹 |
输出内容： - 视频链接： 提供生成视频的网址，可以直接在线观看或分享
3.2 LUMA_API_result_YoC 节点（视频获取器）
这个节点就像一个快递查询系统，你给它一个订单号（文字标识），它就能帮你找到对应的视频。主要用于检查之前生成的视频是否完成，并获取最终结果。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文字标识 | text | 字符串 | 准确的标识码 | 就像快递单号一样，用来找到你要的视频 | 用于识别特定视频的唯一标识符 | 输入之前生成视频时得到的ID号 |
| 下载到本地 | download | True/False | True | 决定找到视频后要不要下载到电脑 | 控制是否将检索到的视频下载到本地 | 设置为True会自动下载，False只获取链接 |
输出内容： - 视频链接： 返回视频的网址，可以用来观看或手动下载
4. 使用技巧和建议
文字描述写作技巧
- 具体明确： 不要只说"一只猫"，要说"一只橙色长毛猫在绿色草地上"
- 动作描述： 加入动态词汇，如"缓慢走动"、"快速奔跑"、"轻柔摆动"
- 环境设定： 说明场景，如"在夕阳西下的海边"、"在雨天的城市街道"
- 情感表达： 可以加入情绪词，如"愉快地"、"安静地"、"兴奋地"
工作流程建议
- 先用 LUMA_API_YoC 生成视频
- 记录返回的视频链接或ID
- 如果需要检查结果，使用 LUMA_API_result_YoC
- 合理使用download参数，如果要立即使用视频就设为True
节约时间的小窍门
- 把常用的文字描述保存成模板
- 批量生成时可以先设置download为False，确认满意后再下载
- 定期清理output文件夹，避免占用太多存储空间
5. 常见问题解答
Q1：为什么生成视频失败？
A： 最常见的原因是cookie信息过期或不正确。确保key.json文件存在于正确目录，并且包含有效的cookie信息。
Q2：视频生成需要多长时间？
A： 这取决于Luma服务器的繁忙程度和你的文字描述复杂度。通常需要几分钟到十几分钟不等。
Q3：生成的视频质量不满意怎么办？
A： 尝试调整文字描述，使其更加具体和清晰。避免使用模糊或矛盾的描述。
Q4：下载的视频保存在哪里？
A： 视频会保存在output/luma video文件夹中。
Q5：可以批量生成视频吗？
A： 可以，但建议控制并发数量，避免过度占用服务器资源。
6. 进阶使用和注意事项
文件管理
- 生成记录会保存在output/luma video/record_id.txt文件中
- 定期备份重要的生成记录
- 为不同项目创建不同的文件夹分类管理
性能优化
- 避免在网络状况不佳时使用插件
- 合理安排生成任务的时间间隔
- 监控本地存储空间，及时清理不需要的视频文件
创意应用
- 可以结合其他ComfyUI节点创建完整的视频制作流程
- 尝试不同风格的文字描述来探索视频生成的可能性
- 可以用生成的视频作为其他创作的素材
法律和道德使用
- 仅用于学习和个人创作目的
- 尊重版权和他人权益
- 不要生成有害或不当内容
这个插件为ComfyUI带来了强大的视频生成能力，让原本复杂的视频制作变得简单易用。通过合理使用这两个核心节点，你可以轻松创建出令人惊叹的视频内容。记住，好的文字描述是成功的关键，多练习多尝试，你会发现无限的创作可能性！