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 — inpaints an image by replacing the masked region with content matching a text prompt

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Inpaints an image by replacing the masked region 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. Use it for mask-based image edits, object replacement, mask-driven face swap, or generative fill.

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.agentutility.ai/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 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-inpaint tool from your MCP-aware agent.

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-describe-api	Describes images from public URLs, producing captions, accessibility alt text, short descriptions, and visual summaries.	$0.02
image-edit	Edits an image from a plain-text instruction, mask-free: describe the change and the model applies it to the whole image.	$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