agentutility(7)$ man banner-image-expand
/banner-image-expand
PRICE / CALL
$0.15
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
synthforgeCATEGORY
uncategorized
STATUS
● live
NAME
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…
synonym alias of image-expand — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/banner-image-expand
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Stretches an existing product or brand photo into a wide banner, hero, or ad canvas by generating new background content around it rather than cropping or distorting the original. Runs on the same image-expand outpainting backend: send image_url, target canvas_width and canvas_height, and an optional prompt describing the extended scene; get back the finished image_url plus its width and height. Use it as a banner image expand API, hero image outpainting tool, website header extender, or ad creative resizer for turning square product shots into wide-format assets.
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 | — |
| width | string | — |
| height | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/banner-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 banner-image-expand tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- synthforgebannerimageexpandbanner-image-expand
- 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 |
| 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 |
| image-expand | Extends a source photo onto a larger canvas, generating realistic new background and content beyond its original edges instead of just st… | $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