ComfyUI Node

Riverflow 2.5 Fast

Thinking, transparency, and a scoring rubric

By Runware·Created 2 years ago·Updated about a month ago· 140
Riverflow 2.5 Fast
  • referenceImages
  • advancedFeatures.watermark.image
  • image
positivePrompt
size1K (16:9)
numberResults1
advancedFeaturesfalse
advancedFeatures.watermark.bgColor
advancedFeatures.watermark.displayPosition(default)
advancedFeatures.watermark.fontColor
advancedFeatures.watermark.opacityfalse
advancedFeatures.watermark.opacity_value0.10
advancedFeatures.watermark.text
settings.backgroundColor
settings.backgroundModeoriginal
settings.enhancePromptfalse
safetyfalse
safety.checkContentfalse
settings.scoringPrompt
settings.thinkingLevelmedium
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95
advanced_json

Riverflow 2.5 is where Sourceful's design model grows a brain. On top of the same product-focused rendering, the 2.5 generation adds three things that change how you use it: an internal thinking level, a scoring prompt that judges its own candidates, and proper background handling including true transparency. That makes this the most interesting Riverflow node in the pack - it's not just "generate an asset," it's "generate an asset, reason about it, and hand back the one that fits your rubric."

This is the Fast tier of 2.5, so it's the cheaper, quicker lane - you pay a little less per image and get a slightly shallower render than Pro. For exploring design directions with the reasoning features on, it's the sensible default. When a direction wins and needs the full-quality pass, that's the Pro sibling.

How it works

positivePromptsourceful:riverflow-2.5@fast as taskType: imageInference → native image (IMAGE) out. The interesting inputs are the 2.5 additions:

  • settings.thinkingLevel - low/medium/high, default medium. The depth of internal reasoning before generating. More thinking = better adherence and more cost.
  • settings.scoringPrompt - a free-text quality rubric. Tell it what "good" means for this job ("sharp product edges, no text artifacts, colors match brand") and it scores candidates against it.
  • settings.backgroundMode - original/transparent/solid, with settings.backgroundColor (hex) composited when mode is solid. Transparent background generation without a separate cutout step is a real workflow saver.
  • settings.enhancePrompt - have the model expand your prompt with use-case context before generating.
  • referenceImages - optional grounding socket.
  • size - the resolution/aspect dropdown (1K/2K, multiple aspect ratios).
  • numberResults - up to 20 variations.

advanced_json takes inputs.fonts and settings.scoringRubric for the heavy setup. Output: image (IMAGE).

Installing

Pack-wide, one install: ComfyUI Manager → Custom Nodes Manager → search Runware → install → restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/Runware/ComfyUI-Runware
pip install -r ComfyUI-Runware/requirements.txt

No model downloads, light deps (runware-sdk, Pillow). API key from the Runware dashboard.

Gotchas

The thinking and scoring features are the cost multipliers - thinkingLevel: high plus a long scoringPrompt plus numberResults: 20 is a very different invoice than the defaults. Start at medium and only climb if the output is missing the rubric. And the rubric only works if you write it in the language the output is judged on: concrete, visual, specific ("crisp edges, correct typography") rather than "make it good." Remember this is Fast - the Pro tier adds a 4K size option and an extra xhigh thinking level for when the asset has to be final.

CategoryRunware/Image/sourceful

Inputs (24)

NameTypeDefaultDescription
positivePromptSTRINGText prompt describing elements to include in the generated output.
referenceImagesoptIMAGE
advancedFeatures.watermark.imageoptIMAGE
sizeoptCOMBO1K (16:9)Output size. Only one of resolution or dimensions is sent.
numberResultsoptINT11–20Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
advancedFeaturesoptBOOLEANfalseEnable to set advancedFeatures. Off uses the model's default.
advancedFeatures.watermark.bgColoroptSTRINGBackground color in hex format.
advancedFeatures.watermark.displayPositionoptCOMBO(default)Watermark position.
advancedFeatures.watermark.fontColoroptSTRINGText color in hex format.
advancedFeatures.watermark.opacityoptBOOLEANfalseEnable to set advancedFeatures.watermark.opacity. Off uses the model's default.
advancedFeatures.watermark.opacity_valueoptFLOAT0.100.1–1Watermark opacity.
advancedFeatures.watermark.textoptSTRINGWatermark text.
settings.backgroundColoroptSTRINGHex color composited when backgroundMode is solid.
settings.backgroundModeoptCOMBOoriginalBackground handling mode for the final output.
settings.enhancePromptoptBOOLEANfalseEnhance the prompt with use-case context before generation.
safetyoptBOOLEANfalseEnable to set safety. Off uses the model's default.
safety.checkContentoptBOOLEANfalseEnable or disable content safety checking.
settings.scoringPromptoptSTRINGFree-text quality rubric used when scoring candidate outputs.
settings.thinkingLeveloptCOMBOmediumControls the depth of internal reasoning the model performs before generating a response.
ttloptBOOLEANfalseEnable to set ttl. Off uses the model's default.
ttl_valueoptINT60Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.
outputFormatoptCOMBOJPGFile format for the generated image.
outputQualityoptINT9520–99Compression quality of the output. Higher values preserve quality but increase file size.
advanced_jsonoptSTRINGOptional JSON merged into the request. For: inputs.fonts, settings.scoringRubric

Outputs (1)

NameTypeDescription
imageIMAGE