Skip to main content

Overview

Tool identifier image_edit. image_edit performs image-to-image editing on a source image following a text instruction (replace elements, change style, and so on). The agent extracts the source image and the edit request from user input — you don’t construct the parameters by hand. It uses its own edit-model environment variable, MODEL_EDIT_NAME (note: different from image_generate’s MODEL_IMAGE_NAME). Import path: from veadk.tools.builtin_tools.image_edit import image_edit

Environment & prerequisites

Requirements:
  1. Configure the API key for the agent’s reasoning model.
  2. Configure the image-editing model name (MODEL_EDIT_NAME).
Environment variables:
  • MODEL_EDIT_API_KEY: API key for the image-editing model; falls back to MODEL_AGENT_API_KEY and then to model.api_key from the config file when unset
  • MODEL_AGENT_API_KEY: API key for the agent’s reasoning model
  • MODEL_EDIT_NAME: image-editing model name
  • MODEL_EDIT_API_BASE: image-editing model API endpoint; defaults to the ModelArk endpoint
Credentials are resolved at tool execution time, not at import time. Importing the tool module does not initialize a client or require credentials to be present.
config.yaml keys:
config.yaml

Usage

examples/tools/image_edit/agent.py
Last modified on September 19, 2026