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 — image edit / instruction-based image edit / text-driven photo edit / nano-banana image editor / gpt-image-2 edit

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Image edit / instruction-based image edit / text-driven photo edit / nano-banana image editor / GPT-image-2 edit. Mask-free instruction-driven image editing — describe the change in text and the model applies it to the whole image. Default model: nano-banana-pro. Returns a permanent fal-hosted PNG URL.

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.org/v1/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 once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the image-edit tool to ..."

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-inpaint	Image inpainting / mask-based image edit / fill in masked region / object replacement / face swap (mask-driven) / generative fill.	$0.02
image-generate	Image generate (fast/cheap) / text-to-image / AI art.	$0.01
sound-effect-generate	Sound effect generation / text-to-SFX / Foley generator / ElevenLabs sound effects / ambient audio synth.	$0.01
music-generate	Music generation / text-to-music / AI music / generative song / instrumental and vocal music.	$0.05
text-to-speech	Text to speech / TTS / voice generator.	$0.05
voice	Text-to-speech / TTS / voice synthesis.	$0.05
remove-bg	AI background remover / background eraser / cutout tool.	$0.08
image-generate-pro	Image generate (pro) / premium text-to-image / Flux 2 Pro / Recraft / Seedream / Qwen Image 2 Pro / xAI Grok Imagine.	$0.10

/image-edit(1)