# MapleAI Image-to-Image Editing

> MapleAI Image-to-Image Editing is a paid API for AI agents from base.mapleai.shop, paid per call via x402, $0.0025/call, status unknown (last checked 2026-10-02).

Edit or transform an existing image using a text prompt, returning a new AI-generated image variant

## Facts

- Endpoint: POST https://base.mapleai.shop/api/v1/images/image2image?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapleai-image-to-image-editing-b73a0f21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DnHNU7YPz0ICkL97hc7b4

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 mapleai-image-to-image-editing-b73a0f21 -d '<json body>'
```

Example prompt: Take this product photo (attached as a JPEG) and use gpt-image-2.5 to make it look like it's set on a sunny beach — generate 1 image at 1024x1024.

## When to prefer this

Choose this endpoint when you have an existing image you want to modify, restyle, or transform using a text prompt — as opposed to generating an image from scratch (text-to-image). Prefer this over the sibling generate endpoint when a source image provides the visual context. Use MapleAI's image-to-image when you want pay-per-request USDC billing via x402 without a subscription, and when you need access to multiple model variants including gpt-image-2, gpt-image-2.5, gpt-image-2.5-flare, gpt-image-2.5-sunburst, or grok-imagine-image.

## Known failure modes

- Image data URI exceeds 10 MB limit — request rejected
- Unsupported image format (not PNG, JPEG, or WebP) — parse error
- Invalid model enum value — validation error
- Requested size not supported by selected model — error response
- Payment not fulfilled via x402 — 402 Payment Required
- n exceeds maximum of 4 — validation error

## How this service works

Edit an image, priced per image and size

## Output

Returns a JSON object with a 'data' array containing URLs to the edited images and a 'created' Unix timestamp. Each URL points to a hosted PNG of the transformed image.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "integer",
   "maximum": 4,
   "minimum": 1
  },
  "size": {
   "type": "string"
  },
  "image": {
   "type": "string",
   "description": "PNG, JPEG or WebP data URI, maximum 10 MB"
  },
  "model": {
   "enum": [
    "gpt-image-2",
    "gpt-image-2.5",
    "gpt-image-2.5-flare",
    "gpt-image-2.5-sunburst",
    "grok-imagine-image",
    "gpt-image-2-2k",
    "gpt-image-2.5-sunburst-2k"
   ],
   "type": "string"
  },
  "prompt": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "url": "https://example.com/image.png"
   }
  ],
  "created": 1700000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-image-to-image-editing-b73a0f21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base.mapleai.shop](https://www.zero.xyz/host/base.mapleai.shop/llms.txt)