Sell 
Sign in / Register 
Location 
Events
Feed
Social
0
Vrool Developers
Fashion API reference
Endpoint and authentication
POST https://vrool.com/gb/content/plugins/vrool_ai/api/makeover.php
Use the regional endpoint shown in your portal. A key issued in one marketplace cannot be used in another. Send the public key and secret in the Authorization header from your server, never browser code. Keep the secret private.
curl -X POST https://vrool.com/gb/content/plugins/vrool_ai/api/makeover.php \
-H "Authorization: Bearer PUBLIC_KEY:SECRET_KEY" \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-H "Content-Type: application/json" \
-d '{"person_image":"https://yourcdn.com/person.jpg","top_image":"https://yourcdn.com/top.jpg"}'Request
| Field | Value |
|---|---|
person_image | Required HTTPS image URL or base64 data URI. |
top_image, bottom_image, shoes_image, outfit_image, clothing_image | Exactly one clothing image per request. Multiple images are rejected before any charge. |
garments | Alternative array of objects with src and optional label. Do not combine this with named clothing fields. Exactly one entry is supported. |
attributes | Not supported by this try-on service. The input person and pose are preserved; non-empty appearance instructions are rejected. |
Idempotency-Key header | Required: unique 16-100 character identifier using letters, digits, period, underscore, colon or hyphen. |
JPEG, PNG or WebP, up to 15 MB per image, 4096 pixels per side and 12 megapixels. JSON requests must be under 24 MB. Image URLs must use HTTPS port 443, resolve to public IPv4 addresses, require no credentials and return the image without redirects.
Sandbox and live
Live generations and credit purchases are currently paused. Sandbox remains available when the API is enabled.
Sandbox keys return a small simulated image with simulated: true and credits_used: 0. Sandbox does not fetch your images or contact an AI provider; it does not test output quality. Live keys require funded credits. One successful generation consumes one paid credit. Failed requests return reserved credits; an interrupted request may need support review.
Only one request per account can run at a time. Rate, daily and monthly limits also apply to sandbox. Spending limits can temporarily pause live requests.
Response
{
"success": true,
"request_id": 123,
"image_base64": "...",
"image_format": "png",
"image_data_uri": "data:image/png;base64,...",
"credits_used": 1,
"credits_remaining": 99,
"mode": "live",
"simulated": false,
"time_ms": 12000
}Store the returned image on your platform. Developer API images are not retained for replay. Reusing an accepted Idempotency-Key returns HTTP 409 without another charge or provider call. After a timeout, check Usage before starting a new request; do not automatically retry with a new identifier.
Errors
| HTTP status | Meaning |
|---|---|
| 400 | Invalid input or missing Idempotency-Key. |
| 401 / 403 | Invalid credentials, revoked key, suspended account or IP restriction. |
| 402 | Paid credits do not cover this request. |
| 409 | Duplicate or unresolved request. Check Usage. |
| 413 | Request too large. |
| 429 | Rate limit or concurrent request. Retry later with the same identifier if not accepted. |
| 502 / 503 | Generation failure, provider spending limit or service paused. |
Credit packs
| Credits | Price | Per generation |
|---|---|---|
| 100 | GBP 10.00 | GBP 0.10 |
| 500 | GBP 45.00 | GBP 0.09 |
| 1000 | GBP 80.00 | GBP 0.08 |
Developer credits are separate from marketplace Try-On credits and Vrool AI+. No recurring developer subscription is currently offered.
Log in 
Register account 
Help 
