> ## 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.

# Luma Image to Video Partner Nodes ComfyUI Official Example

> Learn how to use the Luma Image to Video Partner node in ComfyUI

Luma Image to Video 节点允许你使用 Luma AI 的先进技术将静态图像转换为流畅、动态的视频内容，为图像赋予生命力和动态特性。

本篇指南中，我们将引导你如何使用该节点进行图像转视频的工作流设置。

<Tip>
  使用 API 节点需要保证你已经正常登录，并在受许可的网络环境下使用，请参考[API 节点总览](/zh/tutorials/partner-nodes/overview)部分文档来了解使用 API 节点的具体使用要求。
</Tip>

<Tip>
  <Tabs>
    <Tab title="便携版或手动安装用户">
      请确保你的 ComfyUI 已经更新。

      * [ComfyUI 下载](https://www.comfy.org/download)
      * [ComfyUI 更新教程](/zh/installation/update_comfyui)

      本指南里的工作流可以在 ComfyUI 的[工作流模板](/zh/interface/features/template)中找到。如果找不到，可能是 ComfyUI 没有更新。

      如果加载工作流时有节点缺失，可能原因有：

      1. 你用的不是最新开发版（nightly）。
      2. 你用的是稳定版或桌面版（没有包含最新的更新）。
      3. 启动时有些节点导入失败。
    </Tab>

    <Tab title="桌面版或云端用户">
      * 桌面版是基于 ComfyUI 稳定版本构建的，它会在有新的桌面稳定版本发布时自动更新。
      * [Cloud](https://cloud.comfy.org) 会在 ComfyUI 稳定版本发布后更新，我们会同步更新 Cloud。

      所以，如果你发现本教程中有任何核心节点缺失，那是因为对应的节点支持还在开发中没有发布正式的稳定版，请等待下一个稳定版本发布。
    </Tab>
  </Tabs>
</Tip>

## 使用 Luma 合作伙伴节点的图像转视频工作流

Luma Image to Video 节点需要至少提供一个图像输入（`first_image` 或 `last_image`），结合文本提示词来确定视频的动态效果。在本指南中，我们制作了使用 `first_image` 和 `luma_concepts` 的示例，展示 Luma AI 的视频生成能力。

### 1. 下载工作流

下面的视频的 `metadata` 中已经包含工作流信息，请下载并拖入 ComfyUI 中加载对应工作流。

![Luma Image to Video Workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/luma/i2v/luma_i2v.mp4)

下载以下图像以用作输入：

![Input Image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/luma/i2v/input.png)

### 2. 按步骤完成工作流

<img src="https://mintcdn.com/dripart/OVkvfOwYrH10fL3Y/images/tutorial/api_nodes/luma/luma_i2v_step_guide.jpg?fit=max&auto=format&n=OVkvfOwYrH10fL3Y&q=85&s=f55c824ff729382814a2e86e35b9f309" alt="Luma Image to Video Workflow Steps" width="2492" height="1515" data-path="images/tutorial/api_nodes/luma/luma_i2v_step_guide.jpg" />

按以下基本步骤运行工作流：

1. 在 `first_image` 节点中上传你的输入图像
2. （可选）在 Luma Image to Video 节点中编写提示词，描述你希望图像如何动画
3. （可选）修改 `Luma Concepts` 节点来控制相机运动，实现专业镜头效果
4. 点击 `Run` 或使用 `Ctrl(cmd) + Enter` 来生成视频
5. API 返回结果后，你可以在 `Save Video` 节点中查看生成的视频，视频也会被保存至 `ComfyUI/output/` 目录下

### 3. 补充说明

* **图像输入要求**：`first_image` 和 `last_image` 至少需要提供一个，每个输入最多只接收 1 张图片
* **Luma Concepts**：控制相机运动，提供专业视频效果
* **Seed 参数**：仅用于确定节点是否应重新运行，不影响生成结果
* **启用输入节点**：右键点击紫色 “Bypass” 模式的节点，将 “mode” 设为 “always” 以启用输入
* **模型选择**：不同的视频生成模型具有不同特点，可通过 `model` 参数调整
* **分辨率与时长**：使用 `resolution` 和 `duration` 参数调整输出视频分辨率和时长