# Banner Image Expand (Outpainting)

> Banner Image Expand (Outpainting) is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.15/call, status unknown (last checked 2026-11-06).

Expands an existing image onto a larger canvas using AI outpainting, filling new areas based on an optional text prompt.

## Facts

- Endpoint: POST https://x402.agentutility.ai/banner-image-expand?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-06
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/banner-image-expand-outpainting-4b0fdd1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A3Q5RbQa0iWSmy8bZPq3v

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability banner-image-expand-outpainting-4b0fdd1e -d '<json body>'
```

Example prompt: Take this product photo at https://example.com/product.jpg and expand it to a 1920x640 banner canvas — place the original image centered and fill in the surrounding area with a clean studio background.

## When to prefer this

Use this endpoint when you need to outpaint or extend an existing image onto a larger canvas — especially for creating banners, widescreen crops, or adding background content around a focal subject. Prefer this over a text-to-image generator when you have a source image you want to preserve and extend, not replace. It supports precise placement of the original within the new canvas and accepts a guiding prompt for the generated fill area.

## Known failure modes

- Invalid or inaccessible image_url returns an error or empty response
- Canvas dimensions outside 256–4096 range may be rejected
- Mismatched original_x/original_y or original_width/original_height pairings cause placement errors
- Network timeout if the source image is very large or slow to fetch
- AI generation artifacts if the expansion area is very large relative to the source image

## How this service works

817 pay-per-call APIs for AI agents. Every endpoint is POST /<name> and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON.

## Output

A JSON object containing the URL of the newly generated expanded image (image_url) along with its final pixel dimensions (width and height). The image is hosted and ready to download or embed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "image_url",
      "canvas_width",
      "canvas_height"
     ],
     "properties": {
      "seed": {
       "type": "number",
       "description": "Random seed for reproducible output. Optional; random if omitted."
      },
      "prompt": {
       "type": "string",
       "description": "Text hint describing what to generate in the expanded area. Optional."
      },
      "image_url": {
       "type": "string",
       "description": "Source image URL to expand."
      },
      "original_x": {
       "type": "number",
       "description": "X offset of the original image within the new canvas. Optional; must pair with original_y."
      },
      "original_y": {
       "type": "number",
       "description": "Y offset of the original image within the new canvas. Optional; must pair with original_x."
      },
      "canvas_width": {
       "type": "number",
       "description": "Target canvas width in pixels. 256-4096."
      },
      "canvas_height": {
       "type": "number",
       "description": "Target canvas height in pixels. 256-4096."
      },
      "original_width": {
       "type": "number",
       "description": "Width of the original image within the new canvas. Optional; must pair with original_height."
      },
      "original_height": {
       "type": "number",
       "description": "Height of the original image within the new canvas. Optional; must pair with original_width."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "width": {
       "type": "integer"
      },
      "height": {
       "type": "integer"
      },
      "image_url": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "width": 1920,
  "height": 640,
  "image_url": "https://...png"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/banner-image-expand-outpainting-4b0fdd1e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)