Luma Concepts - ComfyUI 原生节点文档

为Luma图像生成提供概念引导的辅助节点

Luma Concepts 节点允许你将预定义的镜头概念应用到Luma生成过程中，提供更精确的镜头和视角控制，无需复杂的提示词描述。

​

节点功能

此节点作为Luma生成节点的辅助工具，让用户能够选择和应用预定义的镜头概念，这些概念包括不同的拍摄角度(如俯视、仰视)、镜头距离(如特写、远景)、运动方式(如推进、跟随)等摄影参数。它简化了创作工作流程，提供了一种直观的方式来控制生成结果的镜头效果。

​

参数说明

​

基本参数

参数	类型	说明
concept1	选择项	第一个镜头概念选择，包含多种预设镜头选项和”none”
concept2	选择项	第二个镜头概念选择，包含多种预设镜头选项和”none”
concept3	选择项	第三个镜头概念选择，包含多种预设镜头选项和”none”
concept4	选择项	第四个镜头概念选择，包含多种预设镜头选项和”none”

​

可选参数

参数	类型	说明
luma_concepts	LUMA_CONCEPTS	可选的额外Camera Concepts，会与此处选择的镜头概念合并

​

输出

输出	类型	说明
luma_concepts	LUMA_CONCEPT	包含所有选定镜头概念的组合对象

​

使用示例

Luma Text to video 工作流示例

Luma Text to Video 工作流示例

Luma Text to Image 工作流示例

Luma Image to Video 工作流示例

​

工作原理

Luma Concepts 节点提供了丰富的预定义镜头概念供选择，包括但不限于:

• 不同的拍摄距离(如特写、中景、远景)
• 视角高度(如地平、俯视、仰视)
• 运动方式(如推进、跟随、环绕)
• 特殊效果(如手持、稳定、漂浮)

用户可以从这些选项中选择最多4个概念组合使用。节点会创建一个包含所选镜头概念的对象，该对象随后传递给Luma生成节点。在生成过程中，Luma AI会根据这些镜头概念来影响生成结果的视角和构图，确保输出图像体现所选的摄影效果。

通过组合多个镜头概念，用户可以创建复杂的镜头指导，而无需撰写详细的提示词描述。这对于需要特定摄影视角或构图的场景特别有用。

​

源码参考

[节点源码 (更新于2025-05-03)]

class LumaConceptsNode(ComfyNodeABC):
    """
    Holds one or more Camera Concepts for use with Luma Text to Video and Luma Image to Video nodes.
    """

    RETURN_TYPES = (LumaIO.LUMA_CONCEPTS,)
    RETURN_NAMES = ("luma_concepts",)
    DESCRIPTION = cleandoc(__doc__ or "")  # Handle potential None value
    FUNCTION = "create_concepts"
    CATEGORY = "api node/image/Luma"

    @classmethod
    def INPUT_TYPES(s):
        return {
            "required": {
                "concept1": (get_luma_concepts(include_none=True),),
                "concept2": (get_luma_concepts(include_none=True),),
                "concept3": (get_luma_concepts(include_none=True),),
                "concept4": (get_luma_concepts(include_none=True),),
            },
            "optional": {
                "luma_concepts": (
                    LumaIO.LUMA_CONCEPTS,
                    {
                        "tooltip": "Optional Camera Concepts to add to the ones chosen here."
                    },
                ),
            },
        }

    def create_concepts(
        self,
        concept1: str,
        concept2: str,
        concept3: str,
        concept4: str,
        luma_concepts: LumaConceptChain = None,
    ):
        chain = LumaConceptChain(str_list=[concept1, concept2, concept3, concept4])
        if luma_concepts is not None:
            chain = luma_concepts.clone_and_merge(chain)
        return (chain,)