🎥 Watch the workflow demo on YouTube:

🚀 ComfyUI Direct Integration — BFL Flux3 Video I2V Workflow

Generate FLUX 3 videos directly from images inside ComfyUI using the official Black Forest Labs FLUX 3 Video API.

This workflow uses my BFL Flux3 Video custom node to provide direct API integration between ComfyUI and Black Forest Labs, allowing you to build, prompt, submit, monitor, and retrieve FLUX 3 video generations without leaving your ComfyUI workflow.

🖼️ What This Workflow Does

This is an I2V — Image-to-Video workflow.

Use one or two images as the visual starting point for your FLUX 3 generation, optionally enhance your prompt, configure your FLUX 3 video settings, and queue the workflow.

The BFL Flux3 Video node handles:

• 🖼️ Image-to-video generation

• 🌐 Direct communication with the official Black Forest Labs API

• 🔄 Automatic generation-status polling

• 🎞️ Automatic MP4 download

• 🔊 Optional synchronized audio generation

• 📐 Configurable aspect ratio

• ⏱️ Configurable video duration

• 🖥️ HD / FHD generation options

• 🛡️ Configurable safety tolerance

• ⚡ Draft generation

• ✨ draft_enhance support

• 🎥 Native ComfyUI VIDEO output

The generated video can then be passed directly into other compatible ComfyUI video nodes.

🧭 How the I2V Workflow Works

This workflow supports:

Single-keyframe animation

Use one image as the opening frame and let FLUX 3 animate from that starting point.

Two-keyframe animation

Use two images to guide the video from a start frame to an end frame.

This is especially useful for:

• character motion

• scene transitions

• stylized animation

• before/after visual changes

• start-to-end storytelling shots

The BFL Flux3 Video node automatically prepares the image inputs for the API request.

✨ Prompt Enhancement

This workflow also uses my LM Studio Prompt Enhancer custom node, allowing you to refine or expand your initial prompt using a locally running LLM through LM Studio before submitting it to FLUX 3.

You can use the workflow with your own prompt directly, or use the prompt-enhancement stage to create a more detailed cinematic description first.

📦 Required Custom Nodes

You will need:

🎬 BFL Flux 3 Video

By Puppet-Vision

Provides the direct ComfyUI integration with the Black Forest Labs FLUX 3 Video API.

✨ LM Studio Prompt Enhancer

By Puppet-Vision

Provides optional local LLM-powered prompt enhancement through LM Studio.

🔑 Black Forest Labs API Key Required

[!IMPORTANT]
This workflow uses the official hosted Black Forest Labs API.

FLUX 3 Video is not running locally in this workflow.

You need:

• ✅ A Black Forest Labs account

• ✅ A valid BFL_API_KEY

• ✅ Sufficient Black Forest Labs API credits

Create an API key and purchase credits here:

https://dashboard.bfl.ai/

The BFL Flux3 Video node can use either:

BFL_API_KEY

from your environment, or an API key entered directly into the node.

Using the environment variable is recommended when sharing workflows.

💳 API Credits & Generation Costs

Every FLUX 3 generation is processed by Black Forest Labs and consumes BFL API credits according to their current pricing.

[!WARNING]

💸 draft_enhance can consume significantly more credits

Draft generation can be useful for previewing a result before committing to a higher-quality render, but enhancing a draft requires additional API credits.

Check your available BFL credit balance before using draft_enhance.

Billing, API pricing, credit balances, rate limits, and API availability are controlled by Black Forest Labs.

🧠 Basic Workflow

Image / Keyframes
        │
        ▼
LM Studio Prompt Enhancer
        │
        ▼
Enhanced Prompt
        │
        ▼
BFL Flux3 Video
mode = I2V
        │
        ▼
Black Forest Labs FLUX 3 API
        │
        ▼
Generated Video
        │
        ▼
Native ComfyUI VIDEO

⚙️ Typical Settings

Example:

mode             = i2v
aspect_ratio     = 16:9
duration         = 5
resolution       = hd
generate_audio   = true
draft            = false

For a single-image workflow, connect one image to keyframe_1.

For a two-keyframe workflow, connect:

keyframe_1 = starting image
keyframe_2 = ending image

Adjust these settings according to the kind of motion, transformation, and output quality you want.

🔌 Direct ComfyUI Integration

The main purpose of this workflow is to make the official BFL Flux3 Video API feel like a native part of ComfyUI.

Instead of manually creating API requests, polling jobs, downloading results, and importing videos back into ComfyUI, the custom node handles the API workflow automatically.

ComfyUI
   ↓
BFL Flux3 Video Node
   ↓
Official Black Forest Labs API
   ↓
FLUX 3 Generation
   ↓
ComfyUI VIDEO Output

This makes it much easier to incorporate FLUX 3 Video into larger automated ComfyUI pipelines.

⚠️ Disclaimer

This workflow and the associated custom nodes are independent community projects.

I am not affiliated with, endorsed by, sponsored by, or associated with Black Forest Labs or Comfy Org / the ComfyUI organization.

Black Forest Labs, FLUX, FLUX 3, ComfyUI, and related trademarks belong to their respective owners.

API access, billing, pricing, credits, availability, and usage policies are controlled by Black Forest Labs.

🔗 Links & Contact

🔗 ComfyUI BFL Flux 3 Video – GitHub
https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video

🔗 ComfyUI BFL Flux 3 Video Workflows
https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video/tree/main/workflows

🔗 PuppetVision
https://puppetvision.nl