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

$ man image-inpaint

agentutility / synthforge / image-inpaint

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

synthforge

CATEGORY

uncategorized

STATUS

● live

NAME

image-inpaint — image inpainting / mask-based image edit / fill in masked region / object replacement / face swap (mask-driven) / generative fill

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Image inpainting / mask-based image edit / fill in masked region / object replacement / face swap (mask-driven) / generative fill. Replaces the masked region of an image with content matching a text prompt. White pixels in the mask = region to inpaint. Default model: gpt-image-2. 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
mask_url	string	Public http(s) URL of the mask image (white = inpaint region; black = keep).	required
prompt	string	What to fill the masked region with.	required
model	string	Override the inpaint model. Default 'gpt-image-2'.	optional

OUTPUT — response shape

field	type	description
image_url	string	Permanent fal-hosted PNG URL of the inpainted result image with the masked region replaced.
model	string	Identifier of the inpainting model used to generate the edit, e.g. gpt-image-2.
prompt	string	Echoes the text prompt that guided what content to fill into the masked region.
venice_request_id	string	Upstream request ID from the Venice/fal generation call, useful for tracing or support lookups.
source	string	Tag identifying the upstream provider that produced the inpaint, e.g. fal or venice.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/image-inpaint \
  -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-inpaint tool to ..."

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

METADATA

tags: synthforgeimage-editinginpaintingmask-editgenerative-fillobject-replacementgpt-image-2
methods: POST
cluster: synthforge
price: $0.02 USDC per call

ADJACENT — other endpoints in synthforge

endpoint	description	price
image-edit	Image edit / instruction-based image edit / text-driven photo edit / nano-banana image editor / GPT-image-2 edit.	$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-inpaint(1)