agentutility(7)$ man image-expand
/image-expand
PRICE / CALL
$0.15
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
ai
STATUS
● live
NAME
image-expand — extends a source photo onto a larger canvas, generating realistic new background and content beyond its original edges instead of just st…
SYNOPSIS
POST https://x402.agentutility.ai/image-expand
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Extends a source photo onto a larger canvas, generating realistic new background and content beyond its original edges instead of just stretching or cropping it. Send image_url with canvas_width and canvas_height, optionally original_width/original_height and original_x/original_y to place the source image within the new canvas, plus an optional prompt, negative_prompt, and seed for control. Returns the expanded image_url with its final width, height, and seed, using a commercially licensed outpainting model. Use it as an image outpainting API, AI image expansion tool, or background extender for product photos and social crops.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| image_url | string | Source image URL to expand. | required |
| canvas_width | number | Target canvas width in pixels. 256-4096. | required |
| canvas_height | number | Target canvas height in pixels. 256-4096. | required |
| original_width | number | Width of the original image within the new canvas. Optional; must pair with original_height. | optional |
| original_height | number | Height of the original image within the new canvas. Optional; must pair with original_width. | optional |
| original_x | number | X offset of the original image within the new canvas. Optional; must pair with original_y. | optional |
| original_y | number | Y offset of the original image within the new canvas. Optional; must pair with original_x. | optional |
| prompt | string | Text hint describing what to generate in the expanded area. Optional. | optional |
| seed | number | Random seed for reproducible output. Optional; random if omitted. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| image_url | string | URL of the outpainted image with generated content extending beyond the original borders. |
| width | number | Final canvas width in pixels after expansion. |
| height | number | Final canvas height in pixels after expansion. |
| file_size_bytes | number | Size of the output image file in bytes. |
| seed | number | Random seed used by the Bria Expand model for this generation, reusable for reproducible results. |
| source_url | string | URL of the original input image that was expanded. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/image-expand \
-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-expand tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- outpaintexpandimageaibriagenerative
- env
- FAL_KEY
- methods
- POST
- cluster
- synthforge
- price
- $0.15 USDC per call
ADJACENT — other endpoints in synthforge
| endpoint | description | price |
|---|---|---|
| ad-banner-image-expand | Expands existing images into wide, square, or portrait ad banner placements. | $0.15 |
| app-store-screenshot-expand | Expands mobile app screenshots into store, ad, and product-page layouts. | $0.15 |
| banner-image-expand | Stretches an existing product or brand photo into a wide banner, hero, or ad canvas by generating new background content around it rather… | $0.15 |
| course-thumbnail-expand | Expands existing screenshots, instructor photos, or diagrams into 16:9 course thumbnails. | $0.15 |
| email-header-image-expand | Expands existing product, event, or editorial images into wide email-header canvases. | $0.15 |
| linkedin-banner-expand | Expands existing photos into wide LinkedIn banner and social-profile header canvases. | $0.15 |
| marketplace-product-expand | Expands marketplace product images, adapting product shots to marketplace, catalog, and ad aspect ratios. | $0.15 |
| mobile-story-image-expand | Expands existing images into tall story, reel-cover, and short-form promotional canvases. | $0.15 |
SEE ALSO