内置节点参考
Flux 1.1 [pro] Ultra Image - ComfyUI 原生节点文档
使用 Black Forest Labs 的高分辨率图像生成 API 创建图像
![ComfyUI 原生 Flux 1.1 [pro] Ultra Image 节点](/images/built-in-nodes/api_nodes/bfl/flux-1-1-pro-ultra-image.jpg)
Flux 1.1 [pro] Ultra Image 节点允许你通过文本提示词生成超高分辨率的图像，直接连接 Black Forest Labs 的最新图像生成 API。
此节点支持两种主要使用模式：
- 文生图：通过文本提示词生成高质量图像（不使用任何图像收入时）
- 图生图：将现有图像与提示词结合，创建融合两者特点的新图像（Remix 模式）
此节点支持通过 API 调用 Ultra 模式，能够生成 4 倍于标准 Flux 1.1 [pro] 分辨率的图像（高达 4MP），同时不牺牲提示词遵循性，并且保持仅 10 秒的超快生成时间。与其他高分辨率模型相比，生成速度提高了 2.5 倍以上。
参数说明
基本参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| prompt | 字符串 | "" | 生成图像的文本描述 |
| prompt_upsampling | 布尔值 | False | 是否使用提示词上采样技术增强细节。启用后会自动修改提示词以获得更具创造性的生成，但结果会变得不确定（相同种子不会产生完全相同的结果） |
| seed | 整数 | 0 | 随机种子值，控制生成的随机性 |
| aspect_ratio | 字符串 | "16:9" | 图像的宽高比，必须在 1:4 到 4:1 之间 |
| raw | 布尔值 | False | 设置为 True 时，生成更少处理痕迹、更自然的图像 |
可选参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| image_prompt | 图像 | 无 | 可选输入，用于图生图（Remix）模式 |
| image_prompt_strength | 浮点数 | 0.1 | 在有image_prompt 输入时生效，调节提示词与图像提示之间的混合程度，值越大输出越接近输入图像，范围为 0.0-1.0 |
输出
| 输出 | 类型 | 说明 |
|---|---|---|
| IMAGE | 图像 | 生成的高分辨率图像结果 |
使用示例
请访问下面的教程查看对应的使用示例
工作原理
Flux 1.1 [pro] Ultra 模式利用优化的深度学习架构和高效的 GPU 加速技术，在不牺牲速度的情况下实现高分辨率图像生成。当请求发送到 API 后，系统会解析提示词，应用适当的参数，然后并行计算图像，最终生成并返回高分辨率结果。
与常规模型相比，Ultra 模式特别关注细节保留和大尺寸下的一致性，以确保即使在 4MP 的高分辨率下也能保持令人印象深刻的质量。
源码参考
[节点源码 (更新于2025-05-03)]
class FluxProUltraImageNode(ComfyNodeABC):
"""
Generates images synchronously based on prompt and resolution.
"""
MINIMUM_RATIO = 1 / 4
MAXIMUM_RATIO = 4 / 1
MINIMUM_RATIO_STR = "1:4"
MAXIMUM_RATIO_STR = "4:1"
@classmethod
def INPUT_TYPES(s):
return {
"required": {
"prompt": (
IO.STRING,
{
"multiline": True,
"default": "",
"tooltip": "Prompt for the image generation",
},
),
"prompt_upsampling": (
IO.BOOLEAN,
{
"default": False,
"tooltip": "Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation, but results are nondeterministic (same seed will not produce exactly the same result).",
},
),
"seed": (
IO.INT,
{
"default": 0,
"min": 0,
"max": 0xFFFFFFFFFFFFFFFF,
"control_after_generate": True,
"tooltip": "The random seed used for creating the noise.",
},
),
"aspect_ratio": (
IO.STRING,
{
"default": "16:9",
"tooltip": "Aspect ratio of image; must be between 1:4 and 4:1.",
},
),
"raw": (
IO.BOOLEAN,
{
"default": False,
"tooltip": "When True, generate less processed, more natural-looking images.",
},
),
},
"optional": {
"image_prompt": (IO.IMAGE,),
"image_prompt_strength": (
IO.FLOAT,
{
"default": 0.1,
"min": 0.0,
"max": 1.0,
"step": 0.01,
"tooltip": "Blend between the prompt and the image prompt.",
},
),
},
"hidden": {
"auth_token": "AUTH_TOKEN_COMFY_ORG",
},
}
@classmethod
def VALIDATE_INPUTS(cls, aspect_ratio: str):
try:
validate_aspect_ratio(
aspect_ratio,
minimum_ratio=cls.MINIMUM_RATIO,
maximum_ratio=cls.MAXIMUM_RATIO,
minimum_ratio_str=cls.MINIMUM_RATIO_STR,
maximum_ratio_str=cls.MAXIMUM_RATIO_STR,
)
except Exception as e:
return str(e)
return True
RETURN_TYPES = (IO.IMAGE,)
DESCRIPTION = cleandoc(__doc__ or "") # Handle potential None value
FUNCTION = "api_call"
API_NODE = True
CATEGORY = "api node/image/bfl"
def api_call(
self,
prompt: str,
aspect_ratio: str,
prompt_upsampling=False,
raw=False,
seed=0,
image_prompt=None,
image_prompt_strength=0.1,
auth_token=None,
**kwargs,
):
operation = SynchronousOperation(
endpoint=ApiEndpoint(
path="/proxy/bfl/flux-pro-1.1-ultra/generate",
method=HttpMethod.POST,
request_model=BFLFluxProUltraGenerateRequest,
response_model=BFLFluxProGenerateResponse,
),
request=BFLFluxProUltraGenerateRequest(
prompt=prompt,
prompt_upsampling=prompt_upsampling,
seed=seed,
aspect_ratio=validate_aspect_ratio(
aspect_ratio,
minimum_ratio=self.MINIMUM_RATIO,
maximum_ratio=self.MAXIMUM_RATIO,
minimum_ratio_str=self.MINIMUM_RATIO_STR,
maximum_ratio_str=self.MAXIMUM_RATIO_STR,
),
raw=raw,
image_prompt=(
image_prompt
if image_prompt is None
else convert_image_to_base64(image_prompt)
),
image_prompt_strength=(
None if image_prompt is None else round(image_prompt_strength, 2)
),
),
auth_token=auth_token,
)
output_image = handle_bfl_synchronous_operation(operation)
return (output_image,)官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。