# Vimmerse Image to Image

> Vimmerse Image to Image is a paid API for AI agents from agents.vimmerse.net, paid per call via MPP, $0.12/call (dynamic — varies by input), status unknown (last checked 2026-10-30).

Transforms or reimagines a source image using a text prompt, with support for multiple AI models, aspect ratio control, and super-resolution enhancement.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/image/image-2-image?utm_source=zero.xyz
- Price: $0.12/call (dynamic — varies by input)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agents.vimmerse.net
- Website: https://agents.vimmerse.net
- Canonical page: https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-image-to-image-60b34dd0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c9YsbTMaO8udV1NYH_-qW

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 agents-vimmerse-net-vimmerse-image-to-image-60b34dd0 -d '<json body>'
```

Example prompt: Take this image of a shoe (https://media.vimmerse.net/example/uploads/shoe.png) and make it blue with a sky background — use the AutoI model and output 2 variations in 16:9 format with super-resolution enhancement turned on.

## When to prefer this

Choose this endpoint when you need to transform, restyle, or reimagine an existing image guided by a text prompt, rather than generating an image from scratch. It is especially useful when source image structure or content should be preserved while applying style changes, color edits, or background replacements. The variety of model options (AutoI, FluxKontextPro, GPTImage, Seedream, etc.) makes it flexible for different quality/speed tradeoffs. Prefer it over text-to-image when you have a reference image to start from.

## Known failure modes

- Invalid or inaccessible image_url returns an error
- Unsupported aspect_ratio format (not matching \d+:\d+) causes validation failure
- quantity out of range (below 1 or above 4) triggers a validation error
- Insufficient credits returns a payment or authorization error
- Model/option not available may return a service error
- Webhook URL unreachable causes silent callback failure in async mode

## How this service works

Transforms or reimagines a source image using a text prompt.

Provide **`image_url`** (from upload or any public HTTPS URL). Response asset URLs are in **`results`**.

### Parameters

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `image_url` | string | **required** | Source image URL |
| `prompt` | string | `""` | Desired edits or style |
| `option` | string | `AutoI` | Edit model/mode |
| `aspect_ratio` | string | — | Optional output ratio |
| `quantity` | integer | `1` | Variations (1–4) |
| `enhance_image` | boolean | `false` | Super-resolution post-processing |
| `async_mode` | boolean | `false` | Async processing |
| `webhook_url` | string | — | Optional callback |

### Example

```python
import requests

url = "https://api.vimmerse.net/v2/image/image-2-image"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "image_url": "https://media.vimmerse.net/example/uploads/shoe.png",
    "prompt": "Make the shoe blue with a sky background",
    "option": "AutoI",
    "aspect_ratio": "16:9",
    "quantity": 1,
}

response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
print(response.json()["results"])
```

## Output

A JSON response containing a 'results' array with URLs pointing to the transformed image assets. Up to 4 image variations may be returned depending on the 'quantity' parameter. If async_mode is enabled, a job ID is returned for polling instead.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Image2ImageRequest",
 "required": [
  "image_url"
 ],
 "properties": {
  "option": {
   "enum": [
    "AutoI",
    "Seedream",
    "NanoBananaT2",
    "NanoBananaPro",
    "QwenImage",
    "GPTImage",
    "FluxPro",
    "FluxTurbo",
    "ImageUtilsDepth",
    "NanoBanana",
    "FluxKontextPro",
    "StableDiffusion3.5"
   ],
   "type": "string",
   "title": "Option",
   "default": "AutoI"
  },
  "prompt": {
   "type": "string",
   "title": "Prompt",
   "default": "",
   "examples": [
    "Make image more realistic."
   ],
   "description": "Text prompt to edit your image."
  },
  "quantity": {
   "type": "integer",
   "title": "Quantity",
   "default": 1,
   "maximum": 4,
   "minimum": 1,
   "description": "Number of images to generate."
  },
  "image_url": {
   "type": "string",
   "title": "Image URL",
   "description": "URL of the source image."
  },
  "async_mode": {
   "type": "boolean",
   "title": "Async Mode",
   "default": false
  },
  "webhook_url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Webhook URL"
  },
  "aspect_ratio": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^(\\d+):(\\d+)$"
    },
    {
     "type": "null"
    }
   ],
   "title": "Aspect Ratio"
  },
  "enhance_image": {
   "type": "boolean",
   "title": "Enhance Image",
   "default": false,
   "description": "Enhances the image by applying 1× super-resolution during post-processing."
  }
 },
 "description": "Request body for POST /v2/image/image-2-image. Content-Type: application/json."
}
```

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-image-to-image-60b34dd0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.vimmerse.net](https://www.zero.xyz/host/agents.vimmerse.net/llms.txt)