ComfyUI Node

Runway Gen-4 Image Turbo

Reference-driven images on the fast lane

By Runware·Created 2 years ago·Updated about a month ago· 140
Runway Gen-4 Image Turbo
  • referenceImages
  • advancedFeatures.watermark.image
  • image
positivePrompt
size720p (1:1)
numberResults1
advancedFeaturesfalse
advancedFeatures.watermark.bgColor
advancedFeatures.watermark.displayPosition(default)
advancedFeatures.watermark.fontColor
advancedFeatures.watermark.opacityfalse
advancedFeatures.watermark.opacity_value0.10
advancedFeatures.watermark.text
providerSettings.runway.contentModeration.publicFigureThresholdauto
safetyfalse
safety.checkContentfalse
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95

Here's the thing that makes Runway's Gen-4 line different from almost every other text-to-image model you've used: it's reference-first. The referenceImages input isn't optional style guidance - it's the required core of the model. You give Gen-4 one or more images, and it generates new images that hold the identity, the character, the objects from those references. That's the "reliability" Runway has been selling since Gen-3: consistent characters and subjects across generations, without training a LoRA.

This is the Turbo version of the image model, which means the fast distilled lane. Reach for it when you're iterating on characters - "keep this person, this costume, this object, put them in a new scene" - and you want quick turnaround. The same identity-preservation trick local workflows spend an IP-Adapter node and a lot of tuning to get is the default behavior here.

How it works

referenceImages (IMAGE, required) + positivePrompt go to runway:4@2 with taskType: imageInference; the result returns as a native image (IMAGE) tensor. Note the reference images travel as tensors - unlike the video nodes' UUID/URL inputs, this one wires directly from Load Image or any IMAGE-producing node.

Inputs that matter:

  • referenceImages - required. The character/subject you want preserved.
  • positivePrompt - the new scene, pose, or style around the reference.
  • width / height - 1024×1024 default.
  • numberResults - up to 20 seeded variations.
  • providerSettings.runway.contentModeration.publicFigureThreshold - auto/low; loosen if recognizable faces are getting blocked.
  • outputFormat / outputQuality - JPG/PNG/WEBP.

Output: image (IMAGE).

Installing

Pack-wide: 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 reference is the contract - a blurry, low-contrast, or inconsistent reference image produces exactly that character in every output. Give Gen-4 a clean, well-lit shot and it does its best work. Second, "Turbo" means fewer iterations and lower cost per image, but also a quality cap versus the full Gen-4 pipeline; use it for drafts and character exploration. And remember the content-moderation dial: if you're getting refusals on a reference that looks like anyone public, publicFigureThreshold: low is the first thing to try before you rewrite your whole prompt.

CategoryRunware/Image/runway

Inputs (19)

NameTypeDefaultDescription
referenceImagesIMAGE
positivePromptSTRINGText prompt describing elements to include in the generated output.
advancedFeatures.watermark.imageoptIMAGE
sizeoptCOMBO720p (1:1)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.
providerSettings.runway.contentModeration.publicFigureThresholdoptCOMBOautoPublic figure filtering strictness.
safetyoptBOOLEANfalseEnable to set safety. Off uses the model's default.
safety.checkContentoptBOOLEANfalseEnable or disable content safety checking.
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.

Outputs (1)

NameTypeDescription
imageIMAGE