ComfyUI Node

Riverflow 2.5 Pro

The 4K tier with an extra level of thinking

By Runware·Created 2 years ago·Updated about a month ago· 140
Riverflow 2.5 Pro
  • 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 Pro is the top of Sourceful's design-model stack: the full-quality rendering tier, with everything the 2.5 generation brought - internal thinking, a scoring rubric, true transparency - plus a 4K size option and an extra xhigh thinking level that Fast doesn't have. If you're producing final commercial assets - packaging, hero graphics, print - this is the node to finish on. If you're exploring directions, the Fast tier is the cheaper place to do it.

There's a real division of labor in the Riverflow 2.5 pair, and it's worth stating plainly: Fast is the draft machine, Pro is the finisher. Same input contract, same reasoning features, one notch better rendering and one more thinking gear. Iterate cheap on Fast, then swap in Pro when the direction is locked.

How it works

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

  • settings.thinkingLevel - low/medium/high/xhigh. The xhigh gear is Pro-only and it's the full internal-reasoning pass - powerful, and the most expensive setting in the family.
  • settings.scoringPrompt - free-text rubric for judging candidates ("typography crisp, no distortion, brand colors accurate").
  • settings.backgroundMode - original/transparent/solid plus settings.backgroundColor (hex) for the solid mode.
  • settings.enhancePrompt - auto-expand the prompt with use-case context.
  • referenceImages - optional grounding socket.
  • size - a bigger dropdown than Fast: 34 choices including 4K, up from 2K.
  • numberResults - up to 20 variations.

advanced_json takes inputs.fonts and settings.scoringRubric. 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 Pro tier compounds costs: 4K output, xhigh thinking, a scoring pass, and numberResults: 20 all stack. That's the correct tool for a final asset and a painful one for exploration - the title-bar cost per run is your only meter, so actually read it before you queue. Also, don't assume "Pro" means it fixes a weak rubric: scoringPrompt still has to be concrete and visual or the self-scoring is theater. And if you don't need 4K or xhigh, you're paying for capability you're not using - that's what the Fast tier is there for.

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