---
title: "Image To Image"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/image/imagetoimage
markdown: https://docs.nodetool.ai/nodes/nodetool/image/imagetoimage.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/image/imagetoimage.md
---

# Image To Image

**Type:** `nodetool.image.ImageToImage`

**Namespace:** `nodetool.image`

## Description

Transform images using text prompts with any supported image provider. Automatically routes to the appropriate backend (HuggingFace, FAL, MLX).
    image, transformation, AI, image-to-image, i2i

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| model | `image_model` | The image generation model to use | `{"type":"image_model","provider":"huggingface_f...` |
| image | `list[image]` | Input image(s) to transform. The first image is the primary subject; additional images are used as references by providers that support multi-image editing. | `[]` |
| prompt | `str` | Text prompt describing the desired transformation | `A photorealistic version of the input image` |
| negative_prompt | `str` | Text prompt describing what to avoid | `` |
| strength | `float` | How much to transform the input image (subtle = minor edit, strong = major edit) | `0.65` |
| aspect_ratio | `str` | Aspect ratio of the output image | `1:1` |
| resolution | `str` | Output resolution (short edge in pixels) | `1K` |
| scheduler | `str` | Scheduler to use (provider-specific) | `` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| output | `image` |  |

## Related Nodes

Browse other nodes in the [nodetool.image](./) namespace.