Name: image-edit
Price: 0.02 USDC
Availability: InStock

$ man image-edit

agentutility / synthforge / image-edit

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

synthforge

CATEGORY

uncategorized

STATUS

● live

NAME

image-edit — edits an image from a plain-text instruction, mask-free: describe the change and the model applies it to the whole image

SYNOPSIS

POST https://x402.agentutility.ai/image-edit
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Edits an image from a plain-text instruction, mask-free: describe the change and the model applies it to the whole image. Default model: nano-banana-pro. Returns a permanent fal-hosted PNG URL. Use it for instruction-based image editing, text-driven photo edits, nano-banana image editing, or GPT-image-2 edits.

INPUT — request schema

property	type	description	req?
image_url	string	Public http(s) URL of the source image.	required
prompt	string	Edit instructions in plain English.	required
model	string	Override the model. Default 'nano-banana-pro'.	optional

OUTPUT — response shape

field	type	description
image_url	string	Permanent fal-hosted PNG URL of the edited image.
model	string	Model that ran the edit (default nano-banana-pro).
prompt	string	Echoed text instruction that described the edit applied to the source image.
venice_request_id	string	Upstream provider request ID for the edit job, useful for tracing or support.
source	string	Upstream backend that served the edit (e.g. fal, venice).

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/image-edit \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the image-edit tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: synthforgeimage-editinginstruction-edittext-to-image-editnano-bananamask-free-editphoto-editor
methods: POST
cluster: synthforge
price: $0.02 USDC per call

ADJACENT — other endpoints in synthforge

endpoint	description	price
image-describe-api	Describes images from public URLs, producing captions, accessibility alt text, short descriptions, and visual summaries.	$0.02
image-inpaint	Inpaints an image by replacing the masked region with content matching a text prompt.	$0.02
ad-creative-image-generate	Generates ad creative images: SFW marketing visuals, concept images, and campaign thumbnails from prompts.	$0.01
app-icon-image-generate	Generates SFW square app icon concepts, product marks, and launch visuals.	$0.01
blog-header-image-generate	Generates blog header images: SFW header images, newsletter visuals, and documentation illustrations from prompts.	$0.01
book-cover-image-generate	Generates SFW book cover art concepts, genre mood boards, and launch visuals from a prompt.	$0.01
brand-logo-concept-image	Generates SFW logo concept boards, abstract marks, and brand direction visuals from prompts.	$0.01
course-thumbnail-image-generate	Generates SFW course thumbnails, lesson covers, learning-path artwork, and academy launch visuals, without text rendering.	$0.01