# Vimmerse Virtual Try-On

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

Composites clothing from a clothes image URL onto a person in a human image URL to produce a virtual try-on result.

## Facts

- Endpoint: POST https://agents.vimmerse.net/v2/image/try-on?utm_source=zero.xyz
- Price: $0.24/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-virtual-try-on-d0267d4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QILt1F-1PBXV0JhEXZ38j

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-virtual-try-on-d0267d4f -d '<json body>'
```

Example prompt: Can you virtually try on this leather jacket (https://media.vimmerse.net/example/jacket.png) on the model in this photo (https://media.vimmerse.net/example/model.png) using the KlingTryOn option?

## When to prefer this

Choose this endpoint when you need to composite a specific garment image onto a specific person image for virtual try-on use cases, especially for e-commerce, fashion lookbooks, or personalized shopping experiences. It supports multiple backend model options (NanoBananaTryOn, SeedreamTryOn, KlingTryOn, FashnTryOn, KontextTryOn) allowing you to select quality/speed tradeoffs. Prefer this over generic image-to-image endpoints when the specific task is clothing try-on rather than general image transformation.

## Known failure modes

- Invalid or inaccessible image URLs return an error
- Unsupported clothing type or image quality may produce poor compositing
- Invalid option value returns a validation error
- Timeout if images are large and model is slow (up to 300s)
- API key missing or invalid returns 401/402
- Human or clothes image with unsuitable pose/background may degrade output quality

## How this service works

Virtual try-on: composites clothing from **`clothes_image_url`** onto the person in **`human_image_url`**.

### Example

```python
import requests

url = "https://api.vimmerse.net/v2/image/try-on"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "human_image_url": "https://media.vimmerse.net/example/model.png",
    "clothes_image_url": "https://media.vimmerse.net/example/jacket.png",
    "option": "NanoBananaTryOn",
}

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

## Output

A JSON object containing a 'results' field with the URL or data of the composited try-on image showing the specified clothing on the person from the human image.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "TryOnRequest",
 "required": [
  "human_image_url",
  "clothes_image_url"
 ],
 "properties": {
  "option": {
   "type": "string",
   "title": "Virtual Try On Option",
   "default": "NanoBananaTryOn",
   "description": "Available values: `NanoBananaTryOn`, `SeedreamTryOn`, `KlingTryOn`, `FashnTryOn`, `KontextTryOn`."
  },
  "async_mode": {
   "type": "boolean",
   "title": "Async Mode",
   "default": false
  },
  "webhook_url": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Webhook URL"
  },
  "human_image_url": {
   "type": "string",
   "title": "URL of Human Image"
  },
  "clothes_image_url": {
   "type": "string",
   "title": "URL of Clothes Image"
  }
 },
 "description": "Request body for POST /v2/image/try-on. Content-Type: application/json."
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Response Virtual Try On Api V2 Image Try On Post",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-vimmerse-net-vimmerse-virtual-try-on-d0267d4f/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)