{"uid":"cap_QILt1F-1PBXV0JhEXZ38j","slug":"agents-vimmerse-net-vimmerse-virtual-try-on-d0267d4f","name":"Vimmerse Virtual Try-On","description":"Virtual try-on: composites clothing from **`clothes_image_url`** onto the person in **`human_image_url`**.\n\n### Example\n\n```python\nimport requests\n\nurl = \"https://api.vimmerse.net/v2/image/try-on\"\nheaders = {\n    \"X-Api-Key\": \"YOUR_API_KEY\",\n    \"Content-Type\": \"application/json\",\n}\npayload = {\n    \"human_image_url\": \"https://media.vimmerse.net/example/model.png\",\n    \"clothes_image_url\": \"https://media.vimmerse.net/example/jacket.png\",\n    \"option\": \"NanoBananaTryOn\",\n}\n\nresponse = requests.post(url, headers=headers, json=payload, timeout=300)\nresponse.raise_for_status()\nprint(response.json()[\"results\"])\n```","url":"https://agents.vimmerse.net/v2/image/try-on?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."},"responseSchema":{"type":"object","title":"Response Virtual Try On Api V2 Image Try On Post","additionalProperties":true},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.24","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$0.24/call (dynamic — varies by input)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.24","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"0.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4j7eijPGAPJySbcIEG4uO","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.24","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.vimmerse.net","brandSlug":"agents-vimmerse-net-x402","brandBaseUrl":"https://agents.vimmerse.net","brandDocsUrl":null,"whatItDoes":"Composites clothing from a clothes image URL onto a person in a human image URL to produce a virtual try-on result.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"E-commerce product model shoot","prompt":"I have a product photo of a blazer at https://shop.example.com/blazer.png and a model photo at https://shop.example.com/model.jpg — can you generate a try-on image of the model wearing the blazer using the SeedreamTryOn option?"},{"title":"Online shopper outfit preview","prompt":"I want to see how this dress (https://store.example.com/red-dress.png) would look on me — here's my photo: https://myphoto.example.com/me.jpg. Use the FashnTryOn option please."},{"title":"Fashion lookbook content creation","prompt":"Generate a virtual try-on image of this hoodie (https://brand.example.com/hoodie.png) on this influencer photo (https://brand.example.com/influencer.png) using KontextTryOn for our lookbook campaign."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T22:53:37.534Z","isFirstParty":false,"canonicalSlug":"agents-vimmerse-net-vimmerse-virtual-try-on-d0267d4f"}