ComfyUI Extension: wavespeed-comfyui

Authored by WaveSpeedAI

Created

Updated

9 stars

This is a custom node for ComfyUI that allows you to use the WaveSpeed AI API directly in ComfyUI. WaveSpeed AI is a high-performance AI image and video generation service platform offering industry-leading generation speeds. For more information, see a/WaveSpeed AI Documentation.

Custom Nodes (0)

    README

    ComfyUI-WaveSpeedAI-API

    This is a custom node for ComfyUI that allows you to use the WaveSpeed AI API directly in ComfyUI. WaveSpeed AI is a high-performance AI image and video generation service platform offering industry-leading generation speeds. For more information, see WaveSpeed AI Documentation.

    Requirements

    Before using this node, you need to have a WaveSpeed AI API key. You can obtain your API key from the WaveSpeed AI.

    Installation

    Installing manually

    1. Navigate to the ComfyUI/custom_nodes directory.

    2. Clone this repository: git clone https://github.com/WaveSpeedAI/wavespeed-comfyui.git

    3. Install the dependencies:

    • Windows (ComfyUI portable): python -m pip install -r requirements.txt
    • Linux or MacOS: pip install -r requirements.txt
    1. If you don't want to expose your API key in the node, you can rename the config.ini.tmp file to config.ini and add your API key there.

    2. Start ComfyUI and enjoy using the WaveSpeed AI API node!

    How to Use

    The following are typical workflows and result demonstrations (each group includes a ComfyUI workflow screenshot). The workflow images contain workflow information and can be directly dragged into ComfyUI for use.


    1. Dia TTS

    • Workflow Example:

      Dia TTS Workflow


    2. Flux Control LoRA Canny

    • Workflow Example:

      Flux Control LoRA Canny Workflow


    3. Flux Dev Lora Ultra Fast

    • Workflow Example:

      Flux Dev Lora Ultra Fast Workflow


    4. Hunyuan Custom Ref2V 720p Workflow and Result

    • Workflow Example:

      Hunyuan Custom Ref2V 720p Workflow

    • Result Video:

      <video src="examples/hunyuan_custom_ref2v_720p.mp4" controls width="480"></video>


    5. Wan2.1 I2V 720p Ultra Fast Workflow and Result

    • Workflow Example:

      Wan2.1 I2V 720p Ultra Fast Workflow

    • Result Video:

      <video src="examples/wan_2_1_i2v_720p_ultra_fast.mp4" controls width="480"></video>


    Here are some popular models you can experience in ComfyUI:

    1. Hunyuan Custom
    2. Ghibli
    3. Wan2.1

    Here are some nodes list

    • "WaveSpeedAI Client"
    • "WaveSpeedAI Dia TTS"
    • "WaveSpeedAI Flux Control LoRA Canny"
    • "WaveSpeedAI Flux Control LoRA Depth"
    • "WaveSpeedAI Flux Dev"
    • "WaveSpeedAI Flux Dev Fill"
    • "WaveSpeedAI Flux Dev Lora"
    • "WaveSpeedAI Flux Dev Lora Ultra Fast"
    • "WaveSpeedAI Flux Dev Ultra Fast"
    • "WaveSpeedAI Flux Pro Redux"
    • "WaveSpeedAI Flux Redux Dev"
    • "WaveSpeedAI Flux Schnell"
    • "WaveSpeedAI Flux Schnell Lora"
    • "WaveSpeedAI Flux and SDXL Loras"
    • "WaveSpeedAI Framepack"
    • "WaveSpeedAI Ghibli"
    • "WaveSpeedAI Hidream E1 Full"
    • "WaveSpeedAI Hidream I1 Dev"
    • "WaveSpeedAI Hidream I1 Full"
    • "WaveSpeedAI Hunyuan 3D V2 Multi View"
    • "WaveSpeedAI Hunyuan Custom Ref2V 480p"
    • "WaveSpeedAI Hunyuan Custom Ref2V 720p"
    • "WaveSpeedAI Hunyuan Video I2V"
    • "WaveSpeedAI Hunyuan Video T2V"
    • "WaveSpeedAI Instant Character"
    • "WaveSpeedAI Kling v1.6 I2V Pro"
    • "WaveSpeedAI Kling v1.6 I2V Standard"
    • "WaveSpeedAI Kling v1.6 T2V Standard"
    • "WaveSpeedAI LTX Video I2V 480p"
    • "WaveSpeedAI LTX Video I2V 720p"
    • "WaveSpeedAI MMAudio V2"
    • "WaveSpeedAI Magi 1.24b"
    • "WaveSpeedAI Minimax Video 01"
    • "WaveSpeedAI Preview Video"
    • "WaveSpeedAI Real-ESRGAN"
    • "WaveSpeedAI SDXL"
    • "WaveSpeedAI SDXL Lora"
    • "WaveSpeedAI Save Audio"
    • "WaveSpeedAI SkyReels V1"
    • "WaveSpeedAI Step1X Edit"
    • "WaveSpeedAI Uno"
    • "WaveSpeedAI Upload Image"
    • "WaveSpeedAI Vidu Image to Video2.0"
    • "WaveSpeedAI Vidu Reference To Video2.0"
    • "WaveSpeedAI Vidu Start/End To Video2.0"
    • "WaveSpeedAI Wan Loras"
    • "WaveSpeedAI Wan2.1 I2V 480p"
    • "WaveSpeedAI Wan2.1 I2V 480p LoRA Ultra Fast"
    • "WaveSpeedAI Wan2.1 I2V 480p Lora"
    • "WaveSpeedAI Wan2.1 I2V 480p Ultra Fast"
    • "WaveSpeedAI Wan2.1 I2V 720p"
    • "WaveSpeedAI Wan2.1 I2V 720p LoRA Ultra Fast"
    • "WaveSpeedAI Wan2.1 I2V 720p Lora"
    • "WaveSpeedAI Wan2.1 I2V 720p Ultra Fast"
    • "WaveSpeedAI Wan2.1 T2V 480p LoRA"
    • "WaveSpeedAI Wan2.1 T2V 480p LoRA Ultra Fast"
    • "WaveSpeedAI Wan2.1 T2V 480p Ultra Fast"
    • "WaveSpeedAI Wan2.1 T2V 720p"
    • "WaveSpeedAI Wan2.1 T2V 720p LoRA"
    • "WaveSpeedAI Wan2.1 T2V 720p LoRA Ultra Fast"
    • "WaveSpeedAI Wan2.1 T2V 720p Ultra Fast"

    How to Apply Lora

    1. As we provide services on WaveSpeedAI-API, you cannot use your local lora files. However, we support loading lora via URL.
    2. You can use "WaveSpeedAi Wan Loras", "WaveSpeedAi Flux Loras", or "WaveSpeedAi Flux SDXL Loras" nodes.
    3. Enter the lora URL in the lora_path field. For example: https://huggingface.co/WaveSpeedAi/WanLoras/resolve/main/wan_loras.safetensors
    4. Enter the lora weight in the lora_weight field. For example: 0.5
    5. If you have multiple loras, you can add additional lora_path and lora_weight pairs.
    6. If your model is not on Hugging Face, that's fine. Any publicly accessible URL will work.

    How to Use image_url in Nodes

    1. You can use the "WaveSpeedAi Upload Image" node to convert a local IMAGE into an image_url.
    2. Connect the output to the corresponding node that requires it. You can find examples in the provided samples.