ComfyUI Node

Kling IMAGE O3

The one that wants your exact pixel dimensions

By Runware·Created 2 years ago·Updated about a month ago· 140
Kling IMAGE O3
  • referenceImages
  • advancedFeatures.watermark.image
  • image
positivePrompt
size1K (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
safetyfalse
safety.checkContentfalse
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95

Here's the difference that jumps out: Kling IMAGE O3 is the only node in the Kling image line that makes width and height required inputs. The other Kling image nodes hand you a size dropdown; this one asks for exact pixels. That makes O3 the node you reach for when the output has to fit a specific frame - a video canvas, a banner, a character sheet - rather than the other way around.

Why you'd reach for it

Because fixed dimensions are a feature, not a restriction. If you're generating a first frame to feed a Kling video node, or matching an existing asset's aspect, having width and height as first-class inputs is exactly what you want - no fighting a preset dropdown for the right ratio. The trade is that you own the resolution math: too small and you're leaving quality on the table, too big and you're paying for pixels you don't need.

How it works

Generated Runware node, shared pack base class. The required positivePrompt plus width/height (and any optional referenceImages, base64'd to PNG data URIs) go to the Runware REST API via the runware SDK, and the result returns as a native IMAGE tensor. Cost and NSFW flag print on the node title bar. Because image inference is the cheap end of Runware's pricing, even at larger sizes this stays affordable to iterate on.

Inputs that matter

  • positivePrompt - required.
  • width / height - required. Your exact target resolution; this is O3's whole deal.
  • referenceImages (IMAGE) - optional; reference/guided generation when wired.
  • numberResults (1–20) - variations per run, each a separate bill.
  • outputFormat (JPG/PNG/WEBP), outputQuality (95).
  • watermark - optional typed watermark input.
  • safety group - content-check toggles (off = model default).

Output: one image socket (IMAGE type).

Install and the API key

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

Restart ComfyUI (or Runware via ComfyUI Manager). Key from the Runware dashboardSettings → Runware API key, RUNWARE_API_KEY, or runware auth login.

Gotchas

  • Resolution is on you: pick width/height deliberately, because that's the only resolution input here - a 4:5 video-canvas frame and a 16:9 banner are different requests.
  • referenceImages wants tensors (Load Image), not paths or URLs.
  • numberResults up to 20 is a real credit spend - great for batch generation, dangerous for curiosity.
  • Closed Kuaishou model, per-request pricing, cost shown on the node. No weights to download, no local render.

O3 is the precision pick of Kling's image family: exact pixels, high ceilings, and the natural companion to a video pipeline that needs its first frame sized just right.

CategoryRunware/Image/klingai

Inputs (18)

NameTypeDefaultDescription
positivePromptSTRINGText prompt describing elements to include in the generated output.
referenceImagesoptIMAGE
advancedFeatures.watermark.imageoptIMAGE
sizeoptCOMBO1K (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.
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