Custom ComfyUI node for Floyo that wraps the Black Forest Labs FLUX.2 [pro] API. URL-first (no local file paths): you pass URLs and get back a signed output URL for downstream Floyo nodes to download.

Features

Text-to-image generation with width/height, seed, safety tolerance, and output format controls.
Image editing with multi-reference support (input_image + up to 7 extra refs).
Clear URL-only inputs/outputs to match Floyo’s storage pipeline.
Configurable API key via config.ini or BFL_API_KEY env var.
Built-in polling with basic error handling and timeouts.

Installation

Repo layout (mirrors Floyo Seed API style):

nodes/ → node code and helpers
config.ini → API key placeholder
requirements.txt
README.md, __init__.py

Place this repository folder (e.g., Flux2-Pro) into ComfyUI/custom_nodes/.

Install dependencies:

cd Flux2-Pro   # or your folder name under custom_nodes
pip install -r requirements.txt

Add your key to config.ini or export it:

[API]
BFL_API_KEY = <your_real_key>

export BFL_API_KEY=<your_real_key>

Restart ComfyUI.

Nodes and I/O

FLUX.2 [pro] Text-to-Image (`Flux2ProTextToImage`)

Inputs (required): prompt, width, height
Inputs (optional): seed (-1 = random), safety_tolerance (0-6), output_format (jpeg/png)
Output: image_url (STRING, signed URL valid for ~10 minutes)

FLUX.2 [pro] Image Edit (`Flux2ProImageEdit`)

Inputs (required): prompt, input_image (IMAGE tensor) or input_image_url (URL). If both are set, URL wins.
Inputs (optional): input_image_2 … input_image_8 (IMAGE tensors) and matching input_image_2_url … input_image_8_url. URLs win over tensors. Keep total refs <= 8. width, height (0 = match input), seed (-1 = random), safety_tolerance, output_format
Output: image_url (STRING, signed URL valid for ~10 minutes)

Usage Notes

The returned URL expires quickly; run your Floyo download/output node immediately after this node.
API statuses handled: Ready, Pending, and error/moderation states. Failures return an error string in the node output.
Keep total reference images within FLUX.2 [pro] limits (max 8 images, 9MP total). Width/height must be multiples of 16; 0 uses the input image dimensions for edits. Max resolution 4MP (e.g., 2048x2048).
When connecting ComfyUI image tensors, the node auto-converts to base64. If you prefer URLs, fill the URL fields instead.

API Reference

Endpoint: https://api.bfl.ai/v1/flux-2-pro
Docs: https://docs.bfl.ai/quick_start/introduction

README.md Unescape Escape

Floyo FLUX.2 [pro] Custom Node