refine_image
Refine an existing image by performing a denoising pass guided by a text prompt. Control the degree of change with the denoise parameter.
Instructions
Refine an existing image using img2img: fetch the source image, upload it to ComfyUI, and run a denoising pass guided by the prompt. Lower denoise preserves more of the original; higher denoise gives more freedom to the prompt.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | Text prompt describing the desired refined image | |
| source_image_url | Yes | URL of the source image to refine. Will be fetched and uploaded to ComfyUI. | |
| denoise | No | How much to change the source image (0 = no change, 1 = fully regenerate). Typical: 0.3-0.7 | |
| negative_prompt | No | ||
| steps | No | ||
| cfg | No | ||
| seed | No | ||
| checkpoint | No |
Implementation Reference
- src/comfyui/workflows.ts:74-120 (helper)The img2img workflow builder used by refine_image. Builds a ComfyUI workflow with LoadImage, VAEEncode, CLIPTextEncode (pos/neg), CheckpointLoaderSimple, KSampler (with denoise), VAEDecode, and SaveImage nodes.
export function img2img(params: Img2ImgParams): Workflow { return { "3": { class_type: "KSampler", inputs: { seed: params.seed, steps: params.steps, cfg: params.cfg, sampler_name: "euler", scheduler: "normal", denoise: params.denoise, model: ["4", 0], positive: ["6", 0], negative: ["7", 0], latent_image: ["11", 0], }, }, "4": { class_type: "CheckpointLoaderSimple", inputs: { ckpt_name: params.checkpoint }, }, "6": { class_type: "CLIPTextEncode", inputs: { text: params.prompt, clip: ["4", 1] }, }, "7": { class_type: "CLIPTextEncode", inputs: { text: params.negativePrompt, clip: ["4", 1] }, }, "8": { class_type: "VAEDecode", inputs: { samples: ["3", 0], vae: ["4", 2] }, }, "9": { class_type: "SaveImage", inputs: { filename_prefix: "comfyui-mcp-refine", images: ["8", 0] }, }, "10": { class_type: "LoadImage", inputs: { image: params.sourceImage }, }, "11": { class_type: "VAEEncode", inputs: { pixels: ["10", 0], vae: ["4", 2] }, }, }; }