<h2 id="watch-the-workflow-demo-on-youtube:">🎥 <strong>Watch the workflow demo on YouTube:</strong> </h2><div data-youtube-video><iframe width="640" height="480" allowfullscreen="true" autoplay="false" disablekbcontrols="false" enableiframeapi="false" endtime="0" ivloadpolicy="0" loop="false" modestbranding="false" origin playlist src="https://www.youtube.com/embed/4MDFL5CmF24" start="0"></iframe></div><hr /><h1 id="comfyui-direct-integration-bfl-flux3-video-i2v-workflow">🚀 ComfyUI Direct Integration — BFL Flux3 Video I2V Workflow</h1><p>Generate <strong>FLUX 3 videos directly from images inside ComfyUI</strong> using the official <strong>Black Forest Labs FLUX 3 Video API</strong>.</p><p>This workflow uses my <strong>BFL Flux3 Video</strong> custom node to provide direct API integration between <strong>ComfyUI</strong> and <strong>Black Forest Labs</strong>, allowing you to build, prompt, submit, monitor, and retrieve FLUX 3 video generations without leaving your ComfyUI workflow.</p><h2 id="what-this-workflow-does">🖼️ What This Workflow Does</h2><p>This is an <strong>I2V — Image-to-Video</strong> workflow.</p><p>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.</p><p>The <strong>BFL Flux3 Video</strong> node handles:</p><ul><li><p>🖼️ Image-to-video generation</p></li><li><p>🌐 Direct communication with the official Black Forest Labs API</p></li><li><p>🔄 Automatic generation-status polling</p></li><li><p>🎞️ Automatic MP4 download</p></li><li><p>🔊 Optional synchronized audio generation</p></li><li><p>📐 Configurable aspect ratio</p></li><li><p>⏱️ Configurable video duration</p></li><li><p>🖥️ HD / FHD generation options</p></li><li><p>🛡️ Configurable safety tolerance</p></li><li><p>⚡ Draft generation</p></li><li><p>✨ <code>draft_enhance</code> support</p></li><li><p>🎥 Native ComfyUI <code>VIDEO</code> output</p></li></ul><p>The generated video can then be passed directly into other compatible ComfyUI video nodes.</p><hr /><h2 id="how-the-i2v-workflow-works">🧭 How the I2V Workflow Works</h2><p>This workflow supports:</p><h3 id="single-keyframe-animation"><strong>Single-keyframe animation</strong></h3><p>Use one image as the opening frame and let FLUX 3 animate from that starting point.</p><h3 id="two-keyframe-animation"><strong>Two-keyframe animation</strong></h3><p>Use two images to guide the video from a <strong>start frame</strong> to an <strong>end frame</strong>.</p><p>This is especially useful for:</p><ul><li><p>character motion</p></li><li><p>scene transitions</p></li><li><p>stylized animation</p></li><li><p>before/after visual changes</p></li><li><p>start-to-end storytelling shots</p></li></ul><p>The BFL Flux3 Video node automatically prepares the image inputs for the API request.</p><hr /><h2 id="prompt-enhancement">✨ Prompt Enhancement</h2><p>This workflow also uses my <strong>LM Studio Prompt Enhancer</strong> 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.</p><p>You can use the workflow with your own prompt directly, or use the prompt-enhancement stage to create a more detailed cinematic description first.</p><hr /><h2 id="required-custom-nodes">📦 Required Custom Nodes</h2><p>You will need:</p><h3 id="bfl-flux-3-video">🎬 BFL Flux 3 Video</h3><p><strong>By Puppet-Vision</strong></p><p>Provides the direct ComfyUI integration with the Black Forest Labs FLUX 3 Video API.</p><h3 id="lm-studio-prompt-enhancer">✨ LM Studio Prompt Enhancer</h3><p><strong>By Puppet-Vision</strong></p><p>Provides optional local LLM-powered prompt enhancement through LM Studio.</p><hr /><h2 id="black-forest-labs-api-key-required">🔑 Black Forest Labs API Key Required</h2><blockquote><p>[!IMPORTANT]<br />This workflow uses the <strong>official hosted Black Forest Labs API</strong>.</p><p>FLUX 3 Video is <strong>not running locally</strong> in this workflow.</p></blockquote><p>You need:</p><ul><li><p>✅ A Black Forest Labs account</p></li><li><p>✅ A valid <code>BFL_API_KEY</code></p></li><li><p>✅ Sufficient Black Forest Labs API credits</p></li></ul><p>Create an API key and purchase credits here:</p><p><a target="_blank" rel="ugc" href="https://dashboard.bfl.ai/"><strong>https://dashboard.bfl.ai/</strong></a></p><p>The BFL Flux3 Video node can use either:</p><pre><code>BFL_API_KEY
</code></pre><p>from your environment, or an API key entered directly into the node.</p><p>Using the environment variable is recommended when sharing workflows.</p><hr /><h2 id="api-credits-and-generation-costs">💳 API Credits &amp; Generation Costs</h2><p>Every FLUX 3 generation is processed by Black Forest Labs and consumes BFL API credits according to their current pricing.</p><blockquote><p>[!WARNING]</p><h3 id="draft_enhance-can-consume-significantly-more-credits">💸 <code>draft_enhance</code> can consume significantly more credits</h3><p>Draft generation can be useful for previewing a result before committing to a higher-quality render, but enhancing a draft requires additional API credits.</p><p>Check your available BFL credit balance before using <code>draft_enhance</code>.</p></blockquote><p>Billing, API pricing, credit balances, rate limits, and API availability are controlled by <strong>Black Forest Labs</strong>.</p><hr /><h2 id="basic-workflow">🧠 Basic Workflow</h2><pre><code>Image / Keyframes
        │
        ▼
LM Studio Prompt Enhancer
        │
        ▼
Enhanced Prompt
        │
        ▼
BFL Flux3 Video
mode = I2V
        │
        ▼
Black Forest Labs FLUX 3 API
        │
        ▼
Generated Video
        │
        ▼
Native ComfyUI VIDEO
</code></pre><hr /><h2 id="typical-settings">⚙️ Typical Settings</h2><p>Example:</p><pre><code>mode             = i2v
aspect_ratio     = 16:9
duration         = 5
resolution       = hd
generate_audio   = true
draft            = false
</code></pre><p>For a <strong>single-image workflow</strong>, connect one image to <code>keyframe_1</code>.</p><p>For a <strong>two-keyframe workflow</strong>, connect:</p><pre><code>keyframe_1 = starting image
keyframe_2 = ending image
</code></pre><p>Adjust these settings according to the kind of motion, transformation, and output quality you want.</p><hr /><h2 id="direct-comfyui-integration">🔌 Direct ComfyUI Integration</h2><p>The main purpose of this workflow is to make the <strong>official BFL Flux3 Video API feel like a native part of ComfyUI</strong>.</p><p>Instead of manually creating API requests, polling jobs, downloading results, and importing videos back into ComfyUI, the custom node handles the API workflow automatically.</p><pre><code>ComfyUI
   ↓
BFL Flux3 Video Node
   ↓
Official Black Forest Labs API
   ↓
FLUX 3 Generation
   ↓
ComfyUI VIDEO Output
</code></pre><p>This makes it much easier to incorporate FLUX 3 Video into larger automated ComfyUI pipelines.</p><hr /><h2 id="disclaimer">⚠️ Disclaimer</h2><p>This workflow and the associated custom nodes are <strong>independent community projects</strong>.</p><p>I am <strong>not affiliated with, endorsed by, sponsored by, or associated with Black Forest Labs or Comfy Org / the ComfyUI organization</strong>.</p><p>Black Forest Labs, FLUX, FLUX 3, ComfyUI, and related trademarks belong to their respective owners.</p><p>API access, billing, pricing, credits, availability, and usage policies are controlled by Black Forest Labs.</p><hr /><h2 id="links-and-contact">🔗 Links &amp; Contact</h2><p>🔗 <strong>ComfyUI BFL Flux 3 Video – GitHub</strong><br /><a target="_blank" rel="ugc" href="https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video">https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video</a></p><p>🔗 <strong>ComfyUI BFL Flux 3 Video Workflows</strong><br /><a target="_blank" rel="ugc" href="https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video/tree/main/workflows">https://github.com/AllenCraigBarnard/ComfyUI-BFL-Flux-3-video/tree/main/workflows</a></p><p>🔗 <strong>PuppetVision</strong><br /><a target="_blank" rel="ugc" href="https://puppetvision.nl">https://puppetvision.nl</a></p>

Files with SHA256: 98c2667119dbe836b012253003c1638e26d98d18f2ad20025b10115600221cb8