Skip to main content
The Image to Image node uses AI to modify existing images based on text instructions. Use it to edit, transform, or enhance images — for example, adding annotations to financial charts, applying branding to report visuals, redacting sensitive information from document scans, or transforming presentation graphics to match a consistent style.

​
Core Functionality

  • Modify and edit images using AI based on text prompts
  • Support multiple input images (1–3) for best results
  • Select aspect ratio for output images
  • Choose from available image generation providers and models
  • Use personal API keys for dedicated access

​
Tool Inputs

  • Provider * — (Enum (Dropdown), default: Google) Select the model provider
  • Model * — (Enum (Dropdown), default: gemini-2.5-flash-image) Select the image-to-image model
  • Prompt * — (String) Instructions for how the AI should modify the images. Be specific about desired changes
  • Images * — (List<Image>) Array of input images to modify. Provide 1–3 images for best results
  • Aspect Ratio — (Enum (Dropdown), default: 1:1) Select the aspect ratio for the output image. Workflows only
  • Use Personal API Key — (Boolean, default: No) Toggle to use your own API key from the model provider
  • Api Key — (String) Your API key. Only visible when Use Personal API Key is enabled
* indicates a required field

​
Tool Outputs

  • image — (Image) The modified image

​
Overview

The Image to Image tool in agents allows the AI to modify images during conversations based on user requests. The agent can automatically determine what modifications to make based on conversation context, or you can lock specific fields to fixed values.

​
Use Cases

  • Chart annotation — Users can ask the agent to add labels, highlights, or callouts to financial charts and graphs.
  • Brand consistency — Apply consistent branding, color schemes, or watermarks to report visuals during a conversation.
  • Document redaction — Redact sensitive information from document images before sharing.
  • Presentation graphics — Transform or restyle presentation visuals to match corporate templates.

​
How It Works

  1. Add the tool to your agent. In the agent builder, click Add Tool and select Image to Image from the available tools.
  2. Configure input fields. Each field can either be filled automatically by the agent based on conversation context, or locked to a fixed value:
    • Provider — Select the model provider (e.g., Google)
    • Model — Choose the image model (e.g., gemini-2.5-flash-image)
    • Prompt — The agent fills this based on the user’s request, or you can set a fixed instruction
    • Use Personal API Key — Toggle if using your own key
  3. Write the Tool Description. Provide a clear description of what this tool does so the agent knows when to use it. For example: “Use this tool to modify or edit images. Describe the desired changes clearly.”
  4. Set Auto Run behavior. Choose how the tool executes:
    • Auto Run — Executes automatically without user confirmation
    • Require User Approval — Asks the user before executing
    • Let Agent Decide — The agent determines whether to ask for approval
  5. Test the tool. Send a message to the agent with an image and modification instructions to verify the tool works correctly.

​
Settings

SettingTypeDefaultDescription
ProviderDropdownGoogleThe image generation provider.
ModelDropdowngemini-2.5-flash-imageThe image-to-image model.
Use Personal API KeyBooleanNoUse your own API key.

​
Best Practices

  • Write specific prompts. Instead of “make it better,” use precise instructions like “add a red circle highlighting the revenue growth bar in Q4.”
  • Provide 1–3 images. The model works best with a small number of high-quality input images.
  • Use Require User Approval for client-facing agents. This lets users review modifications before they’re applied.

​
Common Issues

For troubleshooting common issues with this node, see the Common Issues documentation.