feat(imagegen): add Prompt Enhancer to MiniMax-H3-Image, P-H3-Image, Krea-2 and MOSS-Image
Browse files- README.md +4 -0
- chain_injectors/prompt_enhancer_injector.py +102 -25
- core/pipelines/workflow_recipes/_partials/conditioning/krea-2.yaml +8 -0
- core/pipelines/workflow_recipes/_partials/conditioning/minimax-h3-image.yaml +7 -0
- core/pipelines/workflow_recipes/_partials/conditioning/moss-image.yaml +8 -0
- core/pipelines/workflow_recipes/_partials/conditioning/p-h3-image.yaml +8 -0
- yaml/chain_features.yaml +3 -3
- yaml/file_list.yaml +7 -2
- yaml/model_architecture_features.yaml +4 -0
- yaml/prompt_enhancer.yaml +99 -16
README.md
CHANGED
|
@@ -63,6 +63,8 @@ models:
|
|
| 63 |
- Comfy-Org/Omnigen2_ComfyUI_repackaged
|
| 64 |
- Comfy-Org/Ovis-Image
|
| 65 |
- Comfy-Org/PixelDiT
|
|
|
|
|
|
|
| 66 |
- Comfy-Org/Qwen3.8-27B
|
| 67 |
- Comfy-Org/Qwen-Image_ComfyUI
|
| 68 |
- Comfy-Org/Qwen-Image-2.1
|
|
@@ -197,6 +199,8 @@ models:
|
|
| 197 |
- OpenMOSS-Team/MOSS-Image-Base
|
| 198 |
- OpenMOSS-Team/MOSS-Image-SFT
|
| 199 |
- PrunaAI/P-H3-Image
|
|
|
|
|
|
|
| 200 |
- Qwen/Qwen3.8-27B
|
| 201 |
- Qwen/Qwen-Image
|
| 202 |
- Qwen/Qwen-Image-2512
|
|
|
|
| 63 |
- Comfy-Org/Omnigen2_ComfyUI_repackaged
|
| 64 |
- Comfy-Org/Ovis-Image
|
| 65 |
- Comfy-Org/PixelDiT
|
| 66 |
+
- Comfy-Org/Qwen3-VL
|
| 67 |
+
- Comfy-Org/Qwen3.5
|
| 68 |
- Comfy-Org/Qwen3.8-27B
|
| 69 |
- Comfy-Org/Qwen-Image_ComfyUI
|
| 70 |
- Comfy-Org/Qwen-Image-2.1
|
|
|
|
| 199 |
- OpenMOSS-Team/MOSS-Image-Base
|
| 200 |
- OpenMOSS-Team/MOSS-Image-SFT
|
| 201 |
- PrunaAI/P-H3-Image
|
| 202 |
+
- Qwen/Qwen3-VL-4B-Instruct
|
| 203 |
+
- Qwen/Qwen3.5-9B
|
| 204 |
- Qwen/Qwen3.8-27B
|
| 205 |
- Qwen/Qwen-Image
|
| 206 |
- Qwen/Qwen-Image-2512
|
chain_injectors/prompt_enhancer_injector.py
CHANGED
|
@@ -7,20 +7,25 @@ flux3_prompt_upsampler injectors into a single implementation driven by
|
|
| 7 |
The YAML declares three independent modules, named after their UI labels in the
|
| 8 |
"Prompt Enhancer Settings" accordion:
|
| 9 |
|
| 10 |
-
* ``architecture`` Model framework -> default ``clip`` (Prompt Enhancer Model)
|
| 11 |
-
default ``system_prompt`` (System Prompt).
|
| 12 |
-
applied whenever the base model changes. A
|
| 13 |
-
first registry item.
|
| 14 |
* ``clip`` Every name shown in the "Prompt Enhancer Model" dropdown,
|
| 15 |
-
mapped to its checkpoint ``filename`` and
|
| 16 |
-
dropdown order.
|
| 17 |
* ``system_prompt`` Every name shown in the "System Prompt" dropdown, mapped to
|
| 18 |
the system prompt sent to ``TextGenerateV2``. An empty value means no system
|
| 19 |
prompt.
|
| 20 |
|
| 21 |
The modules are fully decoupled: any framework may pick any clip, and any clip
|
| 22 |
-
may be paired with any system prompt. ``clip_type``
|
| 23 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
|
| 25 |
The injector then:
|
| 26 |
|
|
@@ -52,6 +57,11 @@ _CONFIG_PATH = os.path.join(_YAML_DIR, "prompt_enhancer.yaml")
|
|
| 52 |
_TARGET_HINTS = (
|
| 53 |
("TextEncodeQwenImage21", ("prompt",), ("prompt",)),
|
| 54 |
("TextEncodeMingImageEdit", ("prompt",), ("prompt",)),
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 55 |
("CLIPTextEncode", ("pos_prompt",), ("text", "prompt")),
|
| 56 |
)
|
| 57 |
|
|
@@ -72,7 +82,7 @@ def load_prompt_enhancer_config():
|
|
| 72 |
|
| 73 |
|
| 74 |
def get_clip_registry():
|
| 75 |
-
"""Return the ordered ``clip name -> {filename, clip_type}`` registry."""
|
| 76 |
return load_prompt_enhancer_config().get("clip", {}) or {}
|
| 77 |
|
| 78 |
|
|
@@ -92,7 +102,7 @@ def get_clip_names():
|
|
| 92 |
|
| 93 |
|
| 94 |
def get_clip_entry(name):
|
| 95 |
-
"""Return the ``{filename, clip_type}`` registry entry for a clip name."""
|
| 96 |
entry = get_clip_registry().get(str(name))
|
| 97 |
return entry if isinstance(entry, dict) else {}
|
| 98 |
|
|
@@ -108,7 +118,7 @@ def get_all_system_prompt_keys():
|
|
| 108 |
|
| 109 |
|
| 110 |
def get_architecture_defaults(framework=None):
|
| 111 |
-
"""Return ``{model, system_prompt}`` defaults for a model framework.
|
| 112 |
|
| 113 |
Reads the ``architecture`` module. Falls back to the first registry entry
|
| 114 |
when the framework is unknown or omits a field, so the UI always has a
|
|
@@ -129,7 +139,11 @@ def get_architecture_defaults(framework=None):
|
|
| 129 |
if system_prompt not in prompt_names:
|
| 130 |
system_prompt = prompt_names[0] if prompt_names else None
|
| 131 |
|
| 132 |
-
return {
|
|
|
|
|
|
|
|
|
|
|
|
|
| 133 |
|
| 134 |
|
| 135 |
def create_node(assembler, class_type, title):
|
|
@@ -202,10 +216,48 @@ def _infer_clip_type(clip_filename):
|
|
| 202 |
if "flux2" in name:
|
| 203 |
print(f"Warning: 'clip_type' missing for '{clip_filename}'; inferred 'flux2' from the filename.")
|
| 204 |
return "flux2"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 205 |
print(f"Warning: 'clip_type' missing for '{clip_filename}'; defaulting to 'qwen_image'. Add it to prompt_enhancer.yaml.")
|
| 206 |
return "qwen_image"
|
| 207 |
|
| 208 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 209 |
def _resolve_model(params, chain_definition=None):
|
| 210 |
"""Pick the Prompt Enhancer Model: explicit request, then framework default, then first registered."""
|
| 211 |
available = get_clip_names()
|
|
@@ -222,9 +274,19 @@ def _resolve_model(params, chain_definition=None):
|
|
| 222 |
if requested in available:
|
| 223 |
return requested
|
| 224 |
# Tolerate the checkpoint filename being supplied instead of the name.
|
| 225 |
-
|
| 226 |
-
|
| 227 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 228 |
# Unknown name: fall through to the framework default.
|
| 229 |
|
| 230 |
defaults = get_architecture_defaults((chain_definition or {}).get("framework"))
|
|
@@ -394,7 +456,7 @@ def inject(assembler, chain_definition, chain_items):
|
|
| 394 |
framework = (chain_definition or {}).get("framework")
|
| 395 |
entry = get_clip_entry(model_name)
|
| 396 |
clip_model_name = str(entry.get("filename") or model_name)
|
| 397 |
-
clip_type =
|
| 398 |
|
| 399 |
target_node_id, class_hint = _find_target_node(assembler, chain_definition)
|
| 400 |
if not target_node_id:
|
|
@@ -421,15 +483,30 @@ def inject(assembler, chain_definition, chain_items):
|
|
| 421 |
except Exception as e:
|
| 422 |
print(f"Warning: Failed to ensure '{clip_model_name}' downloaded: {e}")
|
| 423 |
|
| 424 |
-
# 1. Load the selected Prompt Enhancer Model checkpoint
|
| 425 |
-
|
| 426 |
-
|
| 427 |
-
|
| 428 |
-
|
| 429 |
-
|
| 430 |
-
|
| 431 |
-
|
| 432 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 433 |
|
| 434 |
# 2. Materialise the system prompt when the selected System Prompt carries text
|
| 435 |
system_prompt_conn = None
|
|
|
|
| 7 |
The YAML declares three independent modules, named after their UI labels in the
|
| 8 |
"Prompt Enhancer Settings" accordion:
|
| 9 |
|
| 10 |
+
* ``architecture`` Model framework -> default ``clip`` (Prompt Enhancer Model),
|
| 11 |
+
optional ``clip_type`` override and default ``system_prompt`` (System Prompt).
|
| 12 |
+
These are the dropdown defaults applied whenever the base model changes. A
|
| 13 |
+
missing entry falls back to the first registry item.
|
| 14 |
* ``clip`` Every name shown in the "Prompt Enhancer Model" dropdown,
|
| 15 |
+
mapped to its checkpoint ``filename`` and, when the checkpoint is only valid as
|
| 16 |
+
one encoder, an optional ``clip_type``. Declaration order is dropdown order.
|
| 17 |
* ``system_prompt`` Every name shown in the "System Prompt" dropdown, mapped to
|
| 18 |
the system prompt sent to ``TextGenerateV2``. An empty value means no system
|
| 19 |
prompt.
|
| 20 |
|
| 21 |
The modules are fully decoupled: any framework may pick any clip, and any clip
|
| 22 |
+
may be paired with any system prompt. ``clip_type`` describes the *framework's*
|
| 23 |
+
encoder, not the checkpoint: the same Qwen3.5-9B weights are a ``minimax``
|
| 24 |
+
encoder for MiniMax-H3-Image and a ``moss_image`` encoder for MOSS-Image, and
|
| 25 |
+
the official ComfyUI workflows load them exactly that way. It is therefore
|
| 26 |
+
declared on every ``architecture`` entry and applies to whatever clip the user
|
| 27 |
+
selects, so a MOSS-Image run can host the Qwen-Image-2.1 upsampler as
|
| 28 |
+
``moss_image``. There is no image-based or bbox auto-detection.
|
| 29 |
|
| 30 |
The injector then:
|
| 31 |
|
|
|
|
| 57 |
_TARGET_HINTS = (
|
| 58 |
("TextEncodeQwenImage21", ("prompt",), ("prompt",)),
|
| 59 |
("TextEncodeMingImageEdit", ("prompt",), ("prompt",)),
|
| 60 |
+
("PH3ImageConditioning", ("prompt",), ("prompt",)),
|
| 61 |
+
("MiniMaxH3ImageConditioning", ("prompt",), ("prompt",)),
|
| 62 |
+
("TextEncodeMOSSImageEdit", ("prompt",), ("prompt",)),
|
| 63 |
+
("Krea2EditGroundedEncode", ("prompt",), ("prompt",)),
|
| 64 |
+
("TextEncodeQwenImageEditPlus", ("prompt",), ("prompt",)),
|
| 65 |
("CLIPTextEncode", ("pos_prompt",), ("text", "prompt")),
|
| 66 |
)
|
| 67 |
|
|
|
|
| 82 |
|
| 83 |
|
| 84 |
def get_clip_registry():
|
| 85 |
+
"""Return the ordered ``clip name -> {filename[, clip_type]}`` registry."""
|
| 86 |
return load_prompt_enhancer_config().get("clip", {}) or {}
|
| 87 |
|
| 88 |
|
|
|
|
| 102 |
|
| 103 |
|
| 104 |
def get_clip_entry(name):
|
| 105 |
+
"""Return the ``{filename[, clip_type]}`` registry entry for a clip name."""
|
| 106 |
entry = get_clip_registry().get(str(name))
|
| 107 |
return entry if isinstance(entry, dict) else {}
|
| 108 |
|
|
|
|
| 118 |
|
| 119 |
|
| 120 |
def get_architecture_defaults(framework=None):
|
| 121 |
+
"""Return ``{model, system_prompt, clip_type}`` defaults for a model framework.
|
| 122 |
|
| 123 |
Reads the ``architecture`` module. Falls back to the first registry entry
|
| 124 |
when the framework is unknown or omits a field, so the UI always has a
|
|
|
|
| 139 |
if system_prompt not in prompt_names:
|
| 140 |
system_prompt = prompt_names[0] if prompt_names else None
|
| 141 |
|
| 142 |
+
return {
|
| 143 |
+
"model": model,
|
| 144 |
+
"system_prompt": system_prompt,
|
| 145 |
+
"clip_type": defaults.get("clip_type"),
|
| 146 |
+
}
|
| 147 |
|
| 148 |
|
| 149 |
def create_node(assembler, class_type, title):
|
|
|
|
| 216 |
if "flux2" in name:
|
| 217 |
print(f"Warning: 'clip_type' missing for '{clip_filename}'; inferred 'flux2' from the filename.")
|
| 218 |
return "flux2"
|
| 219 |
+
if "p-h3" in name or "minimax" in name:
|
| 220 |
+
print(f"Warning: 'clip_type' missing for '{clip_filename}'; inferred 'minimax' from the filename.")
|
| 221 |
+
return "minimax"
|
| 222 |
+
if "moss" in name:
|
| 223 |
+
print(f"Warning: 'clip_type' missing for '{clip_filename}'; inferred 'moss_image' from the filename.")
|
| 224 |
+
return "moss_image"
|
| 225 |
+
if "krea2" in name or "krea-2" in name:
|
| 226 |
+
print(f"Warning: 'clip_type' missing for '{clip_filename}'; inferred 'krea2' from the filename.")
|
| 227 |
+
return "krea2"
|
| 228 |
print(f"Warning: 'clip_type' missing for '{clip_filename}'; defaulting to 'qwen_image'. Add it to prompt_enhancer.yaml.")
|
| 229 |
return "qwen_image"
|
| 230 |
|
| 231 |
|
| 232 |
+
def _resolve_clip_type(clip_name, framework=None):
|
| 233 |
+
"""Resolve the ``CLIPLoader.type`` to load the Prompt Enhancer checkpoint with.
|
| 234 |
+
|
| 235 |
+
``clip_type`` is a property of the *framework*, not of the checkpoint: the
|
| 236 |
+
same Qwen3-VL-4B weights are loaded as ``flux3`` by FLUX.3 and as ``krea2``
|
| 237 |
+
by Krea-2, and the same Qwen3.5-9B weights as ``minimax`` by
|
| 238 |
+
MiniMax-H3-Image and as ``moss_image`` by MOSS-Image. The official ComfyUI
|
| 239 |
+
workflows do exactly this.
|
| 240 |
+
|
| 241 |
+
A prompt enhancer is prompt engineering on top of an LLM, so any registered
|
| 242 |
+
upsampler may run under any framework as long as the framework's encoder
|
| 243 |
+
class can host those weights. Resolution order:
|
| 244 |
+
|
| 245 |
+
1. ``architecture[framework].clip_type`` - always wins, including for a clip
|
| 246 |
+
the user picked from another architecture (MOSS-Image + Qwen-Image-2.1 PE
|
| 247 |
+
still loads as ``moss_image``).
|
| 248 |
+
2. ``clip[name].clip_type`` - only for a checkpoint that genuinely cannot be
|
| 249 |
+
re-hosted, and for calls with no framework context.
|
| 250 |
+
3. Filename inference, then ``qwen_image``.
|
| 251 |
+
"""
|
| 252 |
+
defaults = get_architecture_defaults(framework)
|
| 253 |
+
entry = get_clip_entry(clip_name)
|
| 254 |
+
if defaults.get("clip_type"):
|
| 255 |
+
return str(defaults["clip_type"])
|
| 256 |
+
if entry.get("clip_type"):
|
| 257 |
+
return str(entry["clip_type"])
|
| 258 |
+
return _infer_clip_type(str(entry.get("filename") or clip_name))
|
| 259 |
+
|
| 260 |
+
|
| 261 |
def _resolve_model(params, chain_definition=None):
|
| 262 |
"""Pick the Prompt Enhancer Model: explicit request, then framework default, then first registered."""
|
| 263 |
available = get_clip_names()
|
|
|
|
| 274 |
if requested in available:
|
| 275 |
return requested
|
| 276 |
# Tolerate the checkpoint filename being supplied instead of the name.
|
| 277 |
+
# Several registry names may map to one checkpoint file, and the vendor
|
| 278 |
+
# specific upsamplers are fine-tunes of the same Qwen3.5-9B base, so
|
| 279 |
+
# prefer the framework's own default before falling back to declaration
|
| 280 |
+
# order.
|
| 281 |
+
by_filename = [
|
| 282 |
+
name for name in available
|
| 283 |
+
if str(get_clip_entry(name).get("filename") or "") == requested
|
| 284 |
+
]
|
| 285 |
+
if by_filename:
|
| 286 |
+
framework_default = get_architecture_defaults(
|
| 287 |
+
(chain_definition or {}).get("framework")
|
| 288 |
+
)["model"]
|
| 289 |
+
return framework_default if framework_default in by_filename else by_filename[0]
|
| 290 |
# Unknown name: fall through to the framework default.
|
| 291 |
|
| 292 |
defaults = get_architecture_defaults((chain_definition or {}).get("framework"))
|
|
|
|
| 456 |
framework = (chain_definition or {}).get("framework")
|
| 457 |
entry = get_clip_entry(model_name)
|
| 458 |
clip_model_name = str(entry.get("filename") or model_name)
|
| 459 |
+
clip_type = _resolve_clip_type(model_name, framework)
|
| 460 |
|
| 461 |
target_node_id, class_hint = _find_target_node(assembler, chain_definition)
|
| 462 |
if not target_node_id:
|
|
|
|
| 483 |
except Exception as e:
|
| 484 |
print(f"Warning: Failed to ensure '{clip_model_name}' downloaded: {e}")
|
| 485 |
|
| 486 |
+
# 1. Load the selected Prompt Enhancer Model checkpoint. Reuse an existing
|
| 487 |
+
# CLIPLoader with the same checkpoint and type: MOSS-Image and Krea-2 upsample
|
| 488 |
+
# with the very encoder they condition on, and a second loader would hold the
|
| 489 |
+
# same checkpoint twice.
|
| 490 |
+
clip_node_id = None
|
| 491 |
+
for existing_id, existing_node in assembler.workflow.items():
|
| 492 |
+
if not isinstance(existing_node, dict) or existing_node.get('class_type') != 'CLIPLoader':
|
| 493 |
+
continue
|
| 494 |
+
existing_inputs = existing_node.get('inputs', {})
|
| 495 |
+
if (existing_inputs.get('clip_name') == clip_model_name
|
| 496 |
+
and existing_inputs.get('type') == clip_type):
|
| 497 |
+
clip_node_id = existing_id
|
| 498 |
+
print(f"[Injector] Reusing existing CLIPLoader '{existing_id}' for prompt enhancer.")
|
| 499 |
+
break
|
| 500 |
+
|
| 501 |
+
if clip_node_id is None:
|
| 502 |
+
clip_node_id = assembler._get_unique_id()
|
| 503 |
+
clip_node = create_node(assembler, "CLIPLoader", "Load CLIP")
|
| 504 |
+
clip_node['inputs'] = {
|
| 505 |
+
"clip_name": clip_model_name,
|
| 506 |
+
"type": clip_type,
|
| 507 |
+
"device": "default"
|
| 508 |
+
}
|
| 509 |
+
assembler.workflow[clip_node_id] = clip_node
|
| 510 |
|
| 511 |
# 2. Materialise the system prompt when the selected System Prompt carries text
|
| 512 |
system_prompt_conn = None
|
core/pipelines/workflow_recipes/_partials/conditioning/krea-2.yaml
CHANGED
|
@@ -80,6 +80,14 @@ dynamic_pid_chains:
|
|
| 80 |
pid_chain:
|
| 81 |
ksampler_node: "ksampler"
|
| 82 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 83 |
ui_map:
|
| 84 |
positive_prompt: "pos_prompt:text"
|
| 85 |
negative_prompt: "neg_prompt:text"
|
|
|
|
| 80 |
pid_chain:
|
| 81 |
ksampler_node: "ksampler"
|
| 82 |
|
| 83 |
+
# Runs after krea2_identity_edit / krea2_style_reference on purpose (see
|
| 84 |
+
# model_architecture_features.yaml order): both replace the CLIPTextEncode pair with their
|
| 85 |
+
# own encode node, so the prompt enhancer must bind to the replacement node.
|
| 86 |
+
dynamic_prompt_enhancer_chains:
|
| 87 |
+
prompt_enhancer_chain:
|
| 88 |
+
target_node: "pos_prompt"
|
| 89 |
+
framework: "krea-2"
|
| 90 |
+
|
| 91 |
ui_map:
|
| 92 |
positive_prompt: "pos_prompt:text"
|
| 93 |
negative_prompt: "neg_prompt:text"
|
core/pipelines/workflow_recipes/_partials/conditioning/minimax-h3-image.yaml
CHANGED
|
@@ -62,6 +62,13 @@ dynamic_reference_image_chains:
|
|
| 62 |
vae_node: "vae_loader"
|
| 63 |
max_images: 8
|
| 64 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 65 |
ui_map:
|
| 66 |
positive_prompt: "prompt:prompt"
|
| 67 |
negative_prompt: "dummy:negative_prompt"
|
|
|
|
| 62 |
vae_node: "vae_loader"
|
| 63 |
max_images: 8
|
| 64 |
|
| 65 |
+
# The prompt upsampler reads the same reference images the conditioning node holds,
|
| 66 |
+
# so this chain must run after reference_image (see model_architecture_features.yaml order).
|
| 67 |
+
dynamic_prompt_enhancer_chains:
|
| 68 |
+
prompt_enhancer_chain:
|
| 69 |
+
target_node: "prompt"
|
| 70 |
+
framework: "minimax-h3-image"
|
| 71 |
+
|
| 72 |
ui_map:
|
| 73 |
positive_prompt: "prompt:prompt"
|
| 74 |
negative_prompt: "dummy:negative_prompt"
|
core/pipelines/workflow_recipes/_partials/conditioning/moss-image.yaml
CHANGED
|
@@ -89,6 +89,14 @@ dynamic_pid_chains:
|
|
| 89 |
pid_chain:
|
| 90 |
ksampler_node: "ksampler"
|
| 91 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 92 |
ui_map:
|
| 93 |
positive_prompt: "pos_prompt:text"
|
| 94 |
negative_prompt: "neg_prompt:text"
|
|
|
|
| 89 |
pid_chain:
|
| 90 |
ksampler_node: "ksampler"
|
| 91 |
|
| 92 |
+
# Runs after moss_image_edit on purpose (see model_architecture_features.yaml order): that
|
| 93 |
+
# chain replaces the CLIPTextEncode pair with TextEncodeMOSSImageEdit, so the prompt
|
| 94 |
+
# enhancer has to bind to the replacement node or its output would be orphaned.
|
| 95 |
+
dynamic_prompt_enhancer_chains:
|
| 96 |
+
prompt_enhancer_chain:
|
| 97 |
+
target_node: "pos_prompt"
|
| 98 |
+
framework: "moss-image"
|
| 99 |
+
|
| 100 |
ui_map:
|
| 101 |
positive_prompt: "pos_prompt:text"
|
| 102 |
negative_prompt: "neg_prompt:text"
|
core/pipelines/workflow_recipes/_partials/conditioning/p-h3-image.yaml
CHANGED
|
@@ -101,6 +101,14 @@ dynamic_reference_image_chains:
|
|
| 101 |
# Steps / CFG are intentionally discarded: P-H3-Image is trained and sampled on a
|
| 102 |
# fixed 8-step ManualSigmas grid with cfg = 1 (no CFG / no negative prompt).
|
| 103 |
# Pointing these keys at the non-existent "dummy" node makes the assembler skip them.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 104 |
ui_map:
|
| 105 |
positive_prompt: "prompt:prompt"
|
| 106 |
negative_prompt: "dummy:negative_prompt"
|
|
|
|
| 101 |
# Steps / CFG are intentionally discarded: P-H3-Image is trained and sampled on a
|
| 102 |
# fixed 8-step ManualSigmas grid with cfg = 1 (no CFG / no negative prompt).
|
| 103 |
# Pointing these keys at the non-existent "dummy" node makes the assembler skip them.
|
| 104 |
+
|
| 105 |
+
# The prompt upsampler reads the same reference images the conditioning node holds,
|
| 106 |
+
# so this chain must run after reference_image (see model_architecture_features.yaml order).
|
| 107 |
+
dynamic_prompt_enhancer_chains:
|
| 108 |
+
prompt_enhancer_chain:
|
| 109 |
+
target_node: "prompt"
|
| 110 |
+
framework: "p-h3-image"
|
| 111 |
+
|
| 112 |
ui_map:
|
| 113 |
positive_prompt: "prompt:prompt"
|
| 114 |
negative_prompt: "dummy:negative_prompt"
|
yaml/chain_features.yaml
CHANGED
|
@@ -481,9 +481,9 @@ embedding:
|
|
| 481 |
prompt_enhancer:
|
| 482 |
chains: prompt_enhancer
|
| 483 |
display_name: "Prompt Enhancer Settings"
|
| 484 |
-
description: "Enhance or upsample prompts with any registered prompt-enhancer model (Qwen-Image-2.1 PE T2I/I2I, Qwen3.8-27B, FLUX.3 Prompt Upsampler), optional reasoning CoT thinking mode, and optional system prompt. The clip and system_prompt registries are independent, so they are freely mixable across architectures."
|
| 485 |
max_count: 1
|
| 486 |
-
usage_guideline: "Set enable to true to activate prompt enhancement. Pick model from the clip registry and system_prompt from the system_prompt registry in yaml/prompt_enhancer.yaml; both lists are global, so any architecture may select any clip paired with any system prompt. Defaults for each framework come from the architecture section and reset when the base model changes. Nothing is auto-detected from images, so an explicit system prompt always wins. Enable thinking for reasoning CoT (reasoning tags are stripped from the result), and set max_length for generation length."
|
| 487 |
parameters_schema:
|
| 488 |
type: object
|
| 489 |
properties:
|
|
@@ -497,7 +497,7 @@ prompt_enhancer:
|
|
| 497 |
description: "Enable thinking (reasoning CoT). Thought text inside <think> tags is automatically stripped before the prompt reaches downstream text encoding."
|
| 498 |
model:
|
| 499 |
type: string
|
| 500 |
-
description: "Prompt Enhancer Model name from the clip registry in yaml/prompt_enhancer.yaml (e.g. Qwen-Image-2.1-Prompt-Enhancer-T2I,
|
| 501 |
system_prompt:
|
| 502 |
type: string
|
| 503 |
description: "System Prompt name from the system_prompt registry in yaml/prompt_enhancer.yaml (e.g. none, Ming-Image-PE-Template, FLUX.3-T2I-PE-Template, FLUX.3-I2I-PE-Template, FLUX.3-T2I-Bbox-PE-Template, FLUX.3-I2I-Bbox-PE-Template). Independent of the selected clip and never inferred from images; an empty prompt means no system prompt."
|
|
|
|
| 481 |
prompt_enhancer:
|
| 482 |
chains: prompt_enhancer
|
| 483 |
display_name: "Prompt Enhancer Settings"
|
| 484 |
+
description: "Enhance or upsample prompts with any registered prompt-enhancer model (Qwen-Image-2.1 PE T2I/I2I, Qwen3.8-27B, Qwen3.5-9B, Qwen3-VL-4B-Instruct, FLUX.3 Prompt Upsampler, P-H3-Image Prompt Upsampler), optional reasoning CoT thinking mode, and optional system prompt. The clip and system_prompt registries are independent, so they are freely mixable across architectures."
|
| 485 |
max_count: 1
|
| 486 |
+
usage_guideline: "Set enable to true to activate prompt enhancement. Pick model from the clip registry and system_prompt from the system_prompt registry in yaml/prompt_enhancer.yaml; both lists are global, so any architecture may select any clip paired with any system prompt. Defaults for each framework come from the architecture section and reset when the base model changes. architecture[framework].clip_type is the framework's own encoder and applies to whatever clip is selected, so a prompt upsampler built for one vendor still runs under another framework's encoder. Nothing is auto-detected from images, so an explicit system prompt always wins. Enable thinking for reasoning CoT (reasoning tags are stripped from the result), and set max_length for generation length."
|
| 487 |
parameters_schema:
|
| 488 |
type: object
|
| 489 |
properties:
|
|
|
|
| 497 |
description: "Enable thinking (reasoning CoT). Thought text inside <think> tags is automatically stripped before the prompt reaches downstream text encoding."
|
| 498 |
model:
|
| 499 |
type: string
|
| 500 |
+
description: "Prompt Enhancer Model name from the clip registry in yaml/prompt_enhancer.yaml (e.g. Qwen-Image-2.1-Prompt-Enhancer-T2I, Qwen3.8-27B, Qwen3.5-9B, Qwen3-VL-4B-Instruct, Qwen3.5-9B-FLUX.3-Prompt-Upsampler, PrunaAI/P-H3-Image-Prompt-Upsampler). Any model may select any registered clip regardless of architecture. The CLIPLoader type is the framework's, not the checkpoint's: architecture[framework].clip_type applies to whatever clip is selected (same Qwen3.5-9B weights load as `minimax` for MiniMax-H3-Image and `moss_image` for MOSS-Image), so a Qwen-Image-2.1 upsampler still runs as `moss_image` under MOSS-Image. A clip entry may also declare its own clip_type for calls without framework context. Defaults to the architecture entry for the active framework."
|
| 501 |
system_prompt:
|
| 502 |
type: string
|
| 503 |
description: "System Prompt name from the system_prompt registry in yaml/prompt_enhancer.yaml (e.g. none, Ming-Image-PE-Template, FLUX.3-T2I-PE-Template, FLUX.3-I2I-PE-Template, FLUX.3-T2I-Bbox-PE-Template, FLUX.3-I2I-Bbox-PE-Template). Independent of the selected clip and never inferred from images; an empty prompt means no system prompt."
|
yaml/file_list.yaml
CHANGED
|
@@ -993,12 +993,12 @@ file:
|
|
| 993 |
# MOSS-Image
|
| 994 |
- filename: "qwen3.5_9b_w4a8_gptq.safetensors"
|
| 995 |
source: "hf"
|
| 996 |
-
repo_id: "Comfy-Org/
|
| 997 |
repository_file_path: "text_encoders/qwen3.5_9b_w4a8_gptq.safetensors"
|
| 998 |
# Krea-2 / Fibo-2.0
|
| 999 |
- filename: "qwen3vl_4b_fp8_scaled.safetensors"
|
| 1000 |
source: "hf"
|
| 1001 |
-
repo_id: "Comfy-Org/
|
| 1002 |
repository_file_path: "text_encoders/qwen3vl_4b_fp8_scaled.safetensors"
|
| 1003 |
# JoyAI-Image
|
| 1004 |
- filename: "qwen3vl_8b_joyimage_edit_int8_convrot.safetensors"
|
|
@@ -1043,6 +1043,11 @@ file:
|
|
| 1043 |
source: "hf"
|
| 1044 |
repo_id: "black-forest-labs/flux-3-image-klein-comfy"
|
| 1045 |
repository_file_path: "text_encoders/qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1046 |
# PixelDiT
|
| 1047 |
- filename: "gemma_2_2b_it_elm_fp8_scaled.safetensors"
|
| 1048 |
source: "hf"
|
|
|
|
| 993 |
# MOSS-Image
|
| 994 |
- filename: "qwen3.5_9b_w4a8_gptq.safetensors"
|
| 995 |
source: "hf"
|
| 996 |
+
repo_id: "Comfy-Org/Qwen3.5"
|
| 997 |
repository_file_path: "text_encoders/qwen3.5_9b_w4a8_gptq.safetensors"
|
| 998 |
# Krea-2 / Fibo-2.0
|
| 999 |
- filename: "qwen3vl_4b_fp8_scaled.safetensors"
|
| 1000 |
source: "hf"
|
| 1001 |
+
repo_id: "Comfy-Org/Qwen3-VL"
|
| 1002 |
repository_file_path: "text_encoders/qwen3vl_4b_fp8_scaled.safetensors"
|
| 1003 |
# JoyAI-Image
|
| 1004 |
- filename: "qwen3vl_8b_joyimage_edit_int8_convrot.safetensors"
|
|
|
|
| 1043 |
source: "hf"
|
| 1044 |
repo_id: "black-forest-labs/flux-3-image-klein-comfy"
|
| 1045 |
repository_file_path: "text_encoders/qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors"
|
| 1046 |
+
# P-H3-Image Prompt Upsampler
|
| 1047 |
+
- filename: "p-h3-image_prompt_upsampler_w4a8.safetensors"
|
| 1048 |
+
source: "hf"
|
| 1049 |
+
repo_id: "PrunaAI/P-H3-Image-Comfy"
|
| 1050 |
+
repository_file_path: "text_encoders/p-h3-image_prompt_upsampler_w4a8.safetensors"
|
| 1051 |
# PixelDiT
|
| 1052 |
- filename: "gemma_2_2b_it_elm_fp8_scaled.safetensors"
|
| 1053 |
source: "hf"
|
yaml/model_architecture_features.yaml
CHANGED
|
@@ -16,11 +16,13 @@ minimax-h3-image:
|
|
| 16 |
enabled_chains:
|
| 17 |
- lora
|
| 18 |
- reference_image
|
|
|
|
| 19 |
|
| 20 |
p-h3-image:
|
| 21 |
enabled_chains:
|
| 22 |
- lora
|
| 23 |
- reference_image
|
|
|
|
| 24 |
|
| 25 |
krea-2:
|
| 26 |
enabled_chains:
|
|
@@ -28,6 +30,7 @@ krea-2:
|
|
| 28 |
- controlnet
|
| 29 |
- krea2_identity_edit
|
| 30 |
- krea2_style_reference
|
|
|
|
| 31 |
- pid
|
| 32 |
|
| 33 |
sensenova-u1.5:
|
|
@@ -98,6 +101,7 @@ moss-image:
|
|
| 98 |
- lora
|
| 99 |
- moss_image_control
|
| 100 |
- moss_image_edit
|
|
|
|
| 101 |
- pid
|
| 102 |
|
| 103 |
ming-image:
|
|
|
|
| 16 |
enabled_chains:
|
| 17 |
- lora
|
| 18 |
- reference_image
|
| 19 |
+
- prompt_enhancer
|
| 20 |
|
| 21 |
p-h3-image:
|
| 22 |
enabled_chains:
|
| 23 |
- lora
|
| 24 |
- reference_image
|
| 25 |
+
- prompt_enhancer
|
| 26 |
|
| 27 |
krea-2:
|
| 28 |
enabled_chains:
|
|
|
|
| 30 |
- controlnet
|
| 31 |
- krea2_identity_edit
|
| 32 |
- krea2_style_reference
|
| 33 |
+
- prompt_enhancer
|
| 34 |
- pid
|
| 35 |
|
| 36 |
sensenova-u1.5:
|
|
|
|
| 101 |
- lora
|
| 102 |
- moss_image_control
|
| 103 |
- moss_image_edit
|
| 104 |
+
- prompt_enhancer
|
| 105 |
- pid
|
| 106 |
|
| 107 |
ming-image:
|
yaml/prompt_enhancer.yaml
CHANGED
|
@@ -1,32 +1,52 @@
|
|
| 1 |
architecture:
|
| 2 |
flux3:
|
| 3 |
-
clip: "Qwen3.5-9B-FLUX.3-Prompt-Upsampler"
|
|
|
|
| 4 |
system_prompt: "FLUX.3-T2I-PE-Template"
|
| 5 |
-
|
| 6 |
-
clip: "
|
| 7 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 8 |
qwen-image-2.1:
|
| 9 |
-
clip: "Qwen-Image-2.1-
|
|
|
|
| 10 |
system_prompt: "none"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 11 |
|
| 12 |
clip:
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 14 |
filename: "qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors"
|
| 15 |
-
|
| 16 |
-
Qwen-Image-2.1-Prompt-Enhancer-I2I:
|
| 17 |
filename: "qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors"
|
| 18 |
-
|
| 19 |
-
Qwen3.8-27B:
|
| 20 |
filename: "qwen3.8_27b_w4a8.safetensors"
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
| 25 |
|
| 26 |
system_prompt:
|
| 27 |
none: ""
|
| 28 |
-
Ming-Image-PE-Template: |-
|
| 29 |
-
You are a senior visual designer and image-prompt engineer. Expand the user's request into one precise, high-resolution Figma-style caption. Return only one JSON object. Use exactly two top-level keys. `canvas_settings` contains exactly `aspect_ratio`, `ambient_lighting`, and `image_style`. `layers` lists visible groups from background to topmost overlay. Every layer contains exactly `description`, `coordinates`, `hierarchy_and_relation`, and `color_specs`; `color_specs` is an array of hex colors. `coordinates` MUST be one string, never an object or array, in exactly this form: `"cx: 0.500, cy: 0.500, w: 1.000, h: 1.000"`. Values are normalized; each bbox encloses its complete owned object and stays inside the canvas. A layer is one selectable visible semantic group: background, full person, coherent object, panel, card, row, or text block. Prefer the fewest groups that preserve the layout. Keep people and objects intact. Never create invisible parents, guides, placeholders, empty layers, duplicate summaries, or multiple owners for one element. Preserve every user-supplied rendered string character-for-character and as one contiguous string. Unless multiple visible copies are requested, it must occur exactly once across all `description` fields and zero times in `hierarchy_and_relation`. Quote it only where describing its visible rendering; refer to the related subject elsewhere with unquoted semantic wording. Enumerate intended copy, invent extra copy sparingly, and never hide content behind "other text", "remaining labels", or "etc." Describe concrete composition, typography, materials, texture, lighting, pose, and camera treatment without literary filler. Use `hierarchy_and_relation` only for ownership, alignment, containment, stacking, and occlusion. Infer structured layouts first. Use one complete layer per card and state its row and column. A compact secondary table may be one layer only if every header and cell is listed; otherwise use a visible shared frame when present, one complete header, and one complete layer per body row, binding values to columns and stating blanks. Enumerate sequences, schedules, spans, gaps, and vacant tracks in visual order. Do not mistake ordinary alignment for a table. Silently verify schema, string coordinates, Z-order, exact-text counts, geometry, bbox validity, and completeness.
|
| 30 |
FLUX.3-T2I-PE-Template: |-
|
| 31 |
You are the prompt upsampler of a text-to-image model. Expand the user's short request into ONE detailed, self-contained caption: the exact text the image model receives. Output only the caption, with no greetings, explanations, refusals, questions, Markdown, headings, JSON, coordinates, ids or angle-bracket tokens, and no quotes around it. If the input is not clearly an image request, caption a visualization of its concept. The request may begin with a "TARGET CANVAS: W:H" line: compose for that canvas (wide spreads content sideways, tall stacks it) and never mention the ratio or the canvas.
|
| 32 |
|
|
@@ -63,3 +83,66 @@ system_prompt:
|
|
| 63 |
State only decided facts: visible in the source, demanded by the instruction, or a concrete default needed to realize it. Settle whether the edit targets one instance, all of a class or several; land every magnitude on a concrete value; include visible knock-on effects; added objects are new objects at real-world size; a zoom-in names the neighbors it excludes; an outpainting keeps the source whole and continues it in the same medium. Everything the instruction does not involve stays identical to the source.
|
| 64 |
|
| 65 |
Output only the paragraph and the table.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
architecture:
|
| 2 |
flux3:
|
| 3 |
+
clip: "black-forest-labs/Qwen3.5-9B-FLUX.3-Prompt-Upsampler"
|
| 4 |
+
clip_type: flux3
|
| 5 |
system_prompt: "FLUX.3-T2I-PE-Template"
|
| 6 |
+
p-h3-image:
|
| 7 |
+
clip: "PrunaAI/P-H3-Image-Prompt-Upsampler"
|
| 8 |
+
clip_type: minimax
|
| 9 |
+
system_prompt: "none"
|
| 10 |
+
minimax-h3-image:
|
| 11 |
+
clip: "Qwen/Qwen3.5-9B"
|
| 12 |
+
clip_type: minimax
|
| 13 |
+
system_prompt: "MiniMax-H3-Image-PE-Template"
|
| 14 |
+
krea-2:
|
| 15 |
+
clip: "Qwen/Qwen3-VL-4B-Instruct"
|
| 16 |
+
clip_type: krea2
|
| 17 |
+
system_prompt: "Krea-2-PE-Template"
|
| 18 |
qwen-image-2.1:
|
| 19 |
+
clip: "Qwen/Qwen-Image-2.1-PE-T2I"
|
| 20 |
+
clip_type: qwen_image
|
| 21 |
system_prompt: "none"
|
| 22 |
+
moss-image:
|
| 23 |
+
clip: "Qwen/Qwen3.5-9B"
|
| 24 |
+
clip_type: moss_image
|
| 25 |
+
system_prompt: "MOSS-Image-PE-Template"
|
| 26 |
+
ming-image:
|
| 27 |
+
clip: "Qwen/Qwen3.8-27B"
|
| 28 |
+
clip_type: qwen_image
|
| 29 |
+
system_prompt: "Ming-Image-PE-Template"
|
| 30 |
+
|
| 31 |
|
| 32 |
clip:
|
| 33 |
+
black-forest-labs/Qwen3.5-9B-FLUX.3-Prompt-Upsampler:
|
| 34 |
+
filename: "qwen3.5_9b_flux3_prompt_upsampler_w4a8.safetensors"
|
| 35 |
+
PrunaAI/P-H3-Image-Prompt-Upsampler:
|
| 36 |
+
filename: "p-h3-image_prompt_upsampler_w4a8.safetensors"
|
| 37 |
+
Qwen/Qwen-Image-2.1-PE-T2I:
|
| 38 |
filename: "qwen3.5_9b_qwen_image_2.1_pe_t2i.int8_convrot.safetensors"
|
| 39 |
+
Qwen/Qwen-Image-2.1-PE-I2I:
|
|
|
|
| 40 |
filename: "qwen3.5_9b_qwen_image_2.1_pe_i2i.int8_convrot.safetensors"
|
| 41 |
+
Qwen/Qwen3.8-27B:
|
|
|
|
| 42 |
filename: "qwen3.8_27b_w4a8.safetensors"
|
| 43 |
+
Qwen/Qwen3.5-9B:
|
| 44 |
+
filename: "qwen3.5_9b_w4a8_gptq.safetensors"
|
| 45 |
+
Qwen/Qwen3-VL-4B-Instruct:
|
| 46 |
+
filename: "qwen3vl_4b_fp8_scaled.safetensors"
|
| 47 |
|
| 48 |
system_prompt:
|
| 49 |
none: ""
|
|
|
|
|
|
|
| 50 |
FLUX.3-T2I-PE-Template: |-
|
| 51 |
You are the prompt upsampler of a text-to-image model. Expand the user's short request into ONE detailed, self-contained caption: the exact text the image model receives. Output only the caption, with no greetings, explanations, refusals, questions, Markdown, headings, JSON, coordinates, ids or angle-bracket tokens, and no quotes around it. If the input is not clearly an image request, caption a visualization of its concept. The request may begin with a "TARGET CANVAS: W:H" line: compose for that canvas (wide spreads content sideways, tall stacks it) and never mention the ratio or the canvas.
|
| 52 |
|
|
|
|
| 83 |
State only decided facts: visible in the source, demanded by the instruction, or a concrete default needed to realize it. Settle whether the edit targets one instance, all of a class or several; land every magnitude on a concrete value; include visible knock-on effects; added objects are new objects at real-world size; a zoom-in names the neighbors it excludes; an outpainting keeps the source whole and continues it in the same medium. Everything the instruction does not involve stays identical to the source.
|
| 84 |
|
| 85 |
Output only the paragraph and the table.
|
| 86 |
+
MiniMax-H3-Image-PE-Template: |-
|
| 87 |
+
You are the prompt upsampler of a text-to-image model. Rewrite the user's short request into ONE detailed, self-contained English caption: the exact text the image model receives. Output only the caption, with no greetings, explanations, refusals, questions, Markdown, JSON, code fences or quotes around it. If the input is not clearly an image request, caption a visualization of its concept.
|
| 88 |
+
|
| 89 |
+
Role: act like an expert visual designer and technical illustrator, not a word expander. Keep every hard fact from the request, then complete the image with visible, inspectable content. The goal is not more words but that a viewer can inspect each important part of the image and find meaningful subjects, labels, relationships, materials, data and hierarchy. Style comes after content: clean isolation for icons, logos, cutouts and technical assets, layout-rich pages or boards for design communication, believable environment, lighting, lens and depth for photographs. Replace abstract mood and generic adjectives with specific visible cues.
|
| 90 |
+
|
| 91 |
+
First decide which kind of image this is. A depicted scene or photograph prioritizes subject identity, pose, contact, scale, environment, lighting, lens and medium, and physical plausibility. A communication artifact - poster, character card, product-design board, webpage, UI, chart, dashboard, scientific or medical infographic, technical diagram, printed page, packaging, cover, multi-panel composite - needs a finished information architecture, not just a scene containing the requested objects.
|
| 92 |
+
|
| 93 |
+
Universal rules. Keep exact requested text, named entities, counts, formulas, data values, component names, style, medium, orientation and left/right/top/bottom order. Required content must be visible, never implied: place requested text or labels on a surface and say where they sit. For active bodies, solve the scene geometry before pose detail and preserve the domain-native layout first - sport court, game grid, path, lane, stair, room, interface - rather than moving the target or redesigning the ground to obtain a preferred body view. Fix one camera, then place every actor inside that frame with frame-relative terms (screen-left, screen-right, upper, lower, nearer, farther) and derive the body orientation explicitly (front-facing, back-facing, left-facing profile, right-facing profile, front three-quarter, rear three-quarter) together with a frame-absolute motion direction; never use only target-relative phrasing such as "facing the door", and keep gaze, chest, torso lean, leading limb, support foot and motion consistent with it in one frozen phase. A limb cannot be airborne and planted, ahead and behind, or assigned to two contacts. Actions on marked ground use an elevated high-angle oblique or near-overhead three-quarter camera, never a low ground-level view: show the complete contained grid or court, every cell, the source, the target and the full travel path, with the torso outside the map on the ray extending backward from the source and only the support foot entering the near edge of the source cell, keeping hair, clothing and cast shadow clear of every later cell and label, then widen or elevate the framing rather than rotating the actor or relocating the target. For hands, grips, linked fingers, hugs, carrying, pointing, tools, weapons and body-object contact, choose the framing that makes the interaction readable - medium or waist-up when hand or facial detail is central - and state which hand or limb touches what and how the fingers or support points align. Use world knowledge only as visible evidence and add no lore that cannot be seen. Respect the requested subject count and keep crowds, spectators and staff as small silhouettes or graphic texture, not competing main subjects.
|
| 94 |
+
|
| 95 |
+
For communication artifacts, plan a content map first and divide the canvas in reading order into major slots: header or title, subtitle or tagline, hero visual, left panel, right sidebar, card row, icon group, diagram body, process path, chart area, formula box, exploded view, inset, specification area, swatch strip, instruction cards, footer, screen region and background context. Each major slot carries at least three of position, visible text or label, concrete visual subject, function or relationship, material or data treatment, and hierarchy or style treatment; never fill a slot with "icons", "details", "information" or "annotations" without saying what they show. Make the artifact feel complete by adding the few supporting elements its own medium implies - subtitle, role or profile note, quote, ratings, legend, color key, units, variable definitions, dimension labels, back or side view, material stack, use-case icons, footer tips, placeholder logo or code, warning, or a compact specification table - always as short readable on-image labels or one-line captions, never prose blocks. Multi-view outputs such as plan plus render, blueprint plus product, map plus scene or before/after panels share one inventory and coordinate frame, reusing the same walls, openings, components, materials, labels and relative positions in every panel, and name the render camera origin from the plan without inventing major objects the paired view lacks. Dense flowcharts, medical diagrams, route maps and process graphics simplify into a few large numbered nodes, separated lanes or a clean U-shaped loop, with thick, directional, non-crossing arrows attached to named start and end nodes, preferring legible topology and large labels over tiny leaders and decorative clutter.
|
| 96 |
+
|
| 97 |
+
Carry the contract of the artifact type. A scientific, medical or educational infographic needs named section headers, a main diagram with attached component labels, correctly directed arrows with start and end nodes, a legend or color key, short functional captions, key-point cards pairing icon with meaning, definitions and units, a formula box with variable definitions, and the implied system context. Charts, dashboards and data screens need a chart title when useful, axis and tick labels or scale endpoints, units, legend entries, colors, data marks, selected states and values placed consistently with the visual geometry, even on a photographed stage screen. A product or cultural design board needs title, subtitle or tagline, inspiration or use-case cues, a large hero render, motif-specific details, front, back, side and scale insets when useful, exploded layers, manufacturable joints, seams and fasteners, a material stack, finish behaviour, dimension labels, palette swatches and specification icons. A character card or mascot sheet needs identity and name tag, role or about area, readable full-body proportions, attribute rows pairing icon with label and brief meaning, props tied to the role, material swatches and an optional rating, quote, badge or contextual background, so it reads as a designed card rather than a plain portrait. A UI, web or dashboard graphic needs real page or screen sections, navigation, controls, fields, buttons, cards, selected states, labels, values and icons. A public poster, cover or packaging graphic needs typographic hierarchy, headline, subtitle and supporting copy, image slots, badges, borders, requested codes or logo placeholders, palette and intentional negative space, with one clear hero subject per requested category unless a group is asked for.
|
| 98 |
+
|
| 99 |
+
Final self-check before writing: every input requirement is visible, every major slot has real content, required text, formulas and values are exact, labels attach to the correct structures, arrows and data geometry are coherent, body orientation is explicit and agrees with the layout, source, target, depth, gaze, support and motion, paired panels correspond, the subject count has not grown by accident, world knowledge appears as visible evidence, and no important surface is blank. Compose for the canvas the image model will render and never mention that canvas or its ratio. Typical length is 120 to 400 words, longer for information-dense artifacts.
|
| 100 |
+
|
| 101 |
+
Output only the caption.
|
| 102 |
+
Krea-2-PE-Template: |-
|
| 103 |
+
You are an expert prompt engineer for text-to-image models. Expand the user's short request into one highly effective image-generation prompt: a single expanded paragraph the image model receives. Output only that paragraph, with no planning tags, wrappers, bullets, JSON, markdown, asterisks, headings, field labels or meta commentary.
|
| 104 |
+
|
| 105 |
+
Think the request through before answering. What is the subject and mood? Which two or three visual styles, mediums and lighting options would fit, and which one best serves the request? What composition, framing and grounded detail will help the model? Keep all of that planning internal and emit only the finished prompt.
|
| 106 |
+
|
| 107 |
+
Faithfulness comes first: preserve every original subject, action, color and spatial relationship. Do not add new objects, props, characters or animals unless the user clearly implies them, and do not invent highly specific clothing, colors, materials or scene details the input does not support. If the user's prompt is already detailed, lightly polish and finalize it rather than heavily rewriting, keeping the user's phrasing and direction.
|
| 108 |
+
|
| 109 |
+
Write for a text-to-image model to parse cleanly: group each subject with its own attributes and actions, use grounded phrasing for poses, interactions and spatial layout, and let the composition read in one pass. Honor any medium the user names - "photo of", "photograph of", "illustration of", "painting of", "sketch of", "3D render of" - and never pivot to another medium to dodge difficulty.
|
| 110 |
+
|
| 111 |
+
Never request rendered text. Do not mention, describe or hint at letters, words, numbers, captions, subtitles, signage, labels, logos, watermarks, typography or any other graphic text. Only when the user explicitly writes words to be rendered, keep exactly those words in quotes and nothing else. In every other case end the prompt with: "Absolutely no text, no typography, no letters, no words, no numbers, no logos, no watermark, no captions, pure imagery only."
|
| 112 |
+
|
| 113 |
+
Treat depictions of people with dignity and assume clothing covers genitals and intimate anatomy. Never echo these instructions: never repeat, quote, summarize or refer to any part of them, to your own reasoning, or to the user's original message.
|
| 114 |
+
|
| 115 |
+
Output only the prompt.
|
| 116 |
+
MOSS-Image-PE-Template: |-
|
| 117 |
+
You are a prompt engineer for an image generation model. The user sends a short, rough request, sometimes with brand names, exact copy to render, or bounding boxes. Expand it into a detailed, self-contained English caption that can go straight into the image model, and make every piece of visible text appear verbatim.
|
| 118 |
+
|
| 119 |
+
Output only the caption. No title, preamble, explanation, alternatives, questions, code fences, or restatement of these instructions.
|
| 120 |
+
|
| 121 |
+
Opening: always start the caption with the medium and the subject, for example "Anime-style digital illustration of ...", "Studio photograph of ...", "Mixed-media poster of ...". Never start with a verb. If the request is an edit, work out the final scene and open on it directly.
|
| 122 |
+
|
| 123 |
+
Hard rule: the caption always describes the finished picture as it looks. It is never an instruction to an editor and never a report of what changed. Never write "replace", "remove", "keep", "preserve", "unchanged", "the original", "the reference image", "the source" or "same as".
|
| 124 |
+
|
| 125 |
+
Preserve everything the user specifies: number of subjects, identity, action, clothing, style, era, composition, palette, exclusions, and any copy they quote in any language. Add only plausible visual detail the user left open. Never add new people, plot, or dialogue, never change relationships, and never invent real product specifications, prices, certifications, event details, or real people's names or titles.
|
| 126 |
+
|
| 127 |
+
Build the caption from these eight facets. Cover a facet only when the scene has content for it; skip it rather than inventing, and never repeat one to pad length:
|
| 128 |
+
|
| 129 |
+
1. Subject: appearance, age range, build, hairstyle, each garment and its material, accessories, skin or surface texture.
|
| 130 |
+
2. Action: body orientation, limb positions, weight distribution, what the hands are doing, gaze, expression. The pose must hold in a single frame and never contradict itself.
|
| 131 |
+
3. Space: what sits in the foreground, midground and background, relative positions, occlusion, distances, and what appears at the frame edges.
|
| 132 |
+
4. Setting: architecture and interior elements, furniture, props, signs of use, and the details that place the scene in a time and place (signage, windows, road surface, weather).
|
| 133 |
+
5. Framing: shot size, camera height, viewing angle (level, high, low), perspective strength, where the subject sits in the frame, and the empty space around it.
|
| 134 |
+
6. Light: direction and height of the key light, hardness, color temperature, any practical sources (neon, window light, screens), and how the light falls on skin, fabric, glass, metal and wet ground.
|
| 135 |
+
7. Tone: palette, contrast, grain, medium (digital, film, print, 3D render, painting), texture detail, atmosphere.
|
| 136 |
+
8. Text: see the next section. This is the most common failure point.
|
| 137 |
+
|
| 138 |
+
Text rules: keep the user's wording verbatim in its original language (Chinese stays Chinese) and write the full string inside double quotes; never rewrite, translate, shorten, or paste the same copy twice. For each text block state the exact content, its carrier (sign, poster, card face, packaging, screen), position and relative size, typeface style and color, and legibility (clearly readable, slightly blurred, partly occluded). When the user gives no copy but the scene clearly needs text (signs, menus, cards, interfaces), author short, scene-appropriate specific wording and give it verbatim; never write placeholders such as "headline here" or "some text".
|
| 139 |
+
|
| 140 |
+
Writing: flowing natural language, ordered by space or by the viewer's eye, in two to four paragraphs. No tag soup, no "masterpiece, 8k, best quality", no empty quality words. Every sentence must add new visible information; never restate a feature to reach length, and never drop a key detail to stay brief. Aim for 220 to 320 words for a single-subject scene, 320 to 500 for posters, cards, multi-subject scenes and text-heavy layouts, and never fewer than 200 words; a one-word request such as "1girl" still gets a full caption of at least 200 words. Do not pad: if you fall short, add the missing visible detail from the eight facets instead of repeating what you already wrote. Describe only what is visible: no tool steps, generation parameters, or coordinate arithmetic. Even when the request contains canvas sizes, resolution, pixels, or wording like "3:4" or "1024x1024", never repeat any size, ratio or canvas information in the caption.
|
| 141 |
+
|
| 142 |
+
Reference image: decide whether the supplied image is a content source or a style source. It is a content source when the workflow feeds an image in, or when the user says "this image", "reproduce it", "copy it", "same as this", "only change the background" or "only change the copy". Treat its visible content as the baseline and describe it item by item: subject (hair, hair color, eye color, face, build), every garment (outer layer, inner layer, bottoms, footwear, accessories), props and weapons, pose (body orientation, limb positions, how the hands hold things, weight), framing and how much of the frame the subject fills, background elements and palette, light direction, and art style. Change only what the user asks to change and keep the rest. Describe specifically enough to rebuild, never "a similar character" or "a girl in a similar style": say "a girl with short tousled teal-green hair and long uneven bangs, green eyes, an oversized bright red high-collared jacket with black inner panels over a short black dress, bare legs, chunky black ankle boots with red accents, both hands gripping a massive black blade with neon yellow-green edges, full-body frontal view, white background with red, black and lime-green ink splashes". When the user asks for the style only (style transfer, "in this style", "same look"), take the medium, palette, lighting, texture, brushwork and layout logic, and build a new subject and composition instead of copying the original. When the user's text conflicts with the image, the text wins (blue hair means blue hair); everything the text does not mention follows the image. With a very short request such as "1girl" plus a reference image, do not improvise: appearance, clothing, palette, background and style all come from the image, and your job is only to write them out as a complete English caption, adding no accessory, weapon, prop or scenery the image does not show. If a detail in the image is unreadable, leave it out rather than guessing, and never guess brands, identities or real names. Keep readable text inside the reference image verbatim under the text rules and write unreadable marks as "illegible blurred lettering" instead of inventing content. Never copy watermarks, platform badges or logos the user did not ask for. If no image is supplied, do not pretend you saw one: expand the text only, keep every feature the user already gave, and invent no character details. A reference is evidence, not the deliverable, so state the result as plain visible fact and ban edit verbs and comparative pointers ("replace", "remove", "keep", "preserve", "unchanged", "same as", "as in the reference", "the original", "the source", "just like"). Keep the number of subjects consistent with what the user asks for, and when they ask to replace the subject, the original subject must not appear in the caption at all.
|
| 143 |
+
|
| 144 |
+
Bounding boxes: boxes are absolute pixel xyxy (top-left, bottom-right) and are placement instructions only. Use them as given: never normalize, center, reorder, percentage-convert or recompute them. With one box, describe only what is inside it in one to three sentences, with no coordinates, no numbering and no commentary; a text box also states typeface, color, carrier and legibility, with the copy verbatim in double quotes. With several boxes, write one line per box in the given order formatted as "index | English description", describing only the content inside that box, with no coordinates, no JSON and no prose paragraphs. A box marks a placement, not a border, panel, divider or sticker to draw; overlap and natural occlusion are allowed. With no boxes, write a normal caption and never invent coordinates.
|
| 145 |
+
|
| 146 |
+
Output only the caption.
|
| 147 |
+
Ming-Image-PE-Template: |-
|
| 148 |
+
You are a senior visual designer and image-prompt engineer. Expand the user's request into one precise, high-resolution Figma-style caption. Return only one JSON object. Use exactly two top-level keys. `canvas_settings` contains exactly `aspect_ratio`, `ambient_lighting`, and `image_style`. `layers` lists visible groups from background to topmost overlay. Every layer contains exactly `description`, `coordinates`, `hierarchy_and_relation`, and `color_specs`; `color_specs` is an array of hex colors. `coordinates` MUST be one string, never an object or array, in exactly this form: `"cx: 0.500, cy: 0.500, w: 1.000, h: 1.000"`. Values are normalized; each bbox encloses its complete owned object and stays inside the canvas. A layer is one selectable visible semantic group: background, full person, coherent object, panel, card, row, or text block. Prefer the fewest groups that preserve the layout. Keep people and objects intact. Never create invisible parents, guides, placeholders, empty layers, duplicate summaries, or multiple owners for one element. Preserve every user-supplied rendered string character-for-character and as one contiguous string. Unless multiple visible copies are requested, it must occur exactly once across all `description` fields and zero times in `hierarchy_and_relation`. Quote it only where describing its visible rendering; refer to the related subject elsewhere with unquoted semantic wording. Enumerate intended copy, invent extra copy sparingly, and never hide content behind "other text", "remaining labels", or "etc." Describe concrete composition, typography, materials, texture, lighting, pose, and camera treatment without literary filler. Use `hierarchy_and_relation` only for ownership, alignment, containment, stacking, and occlusion. Infer structured layouts first. Use one complete layer per card and state its row and column. A compact secondary table may be one layer only if every header and cell is listed; otherwise use a visible shared frame when present, one complete header, and one complete layer per body row, binding values to columns and stating blanks. Enumerate sequences, schedules, spans, gaps, and vacant tracks in visual order. Do not mistake ordinary alignment for a table. Silently verify schema, string coordinates, Z-order, exact-text counts, geometry, bbox validity, and completeness.
|