Corlen
Get API keys

Try-on API · REST · Async

Virtual try-on, as a simple REST API.

The same engine behind Corlen's Shopify app and in-store kiosk, available directly: send a photo and a garment, start a job, poll it until it's done.

Get API keysRead the docs

7-day free trial · 10 generations · no credit card needed

01 · Integration

Start it. Poll it. Done.

Every generation is asynchronous. A POST starts the job and returns a jobId in about a second; a GET tells you when the image is ready. No polling faster than every 2-3 seconds, and no webhook required, though your own server can poll on whatever schedule fits your app.

Full quickstart →
curl -X POST https://corlen.io/api/v1/tryon \
  -H "Authorization: Bearer corlen_live_..." \
  -d '{ "customerPhotoBase64": "...", "garmentImageUrl": "...", "category": "upper_body" }'
# -> { "jobId": "b1e4...", "status": "processing" }

curl https://corlen.io/api/v1/tryon/b1e4... \
  -H "Authorization: Bearer corlen_live_..."
# -> { "status": "completed", "resultImageBase64": "..." }
POST/api/v1/tryon
Start a single-garment try-on. Returns a jobId immediately.
POST/api/v1/tryon/combo
Start a 2-4 garment combo look in one request.
GET/api/v1/tryon/{jobId}
Poll for the result. Returns processing, completed, or failed.

02 · Coverage

Every garment, one shape.

One request shape handles tops, bottoms, and full-body garments alike, just a category field: upper_body, lower_body, or full_body. Combine 2 to 4 garments into one finished look with the combo endpoint. Open/closed jackets, front/back angles, and tucked/untucked shirts are all supported fields, not separate products.

upper_bodylower_bodyfull_bodycombo (2-4 garments)front / left / right / backopen / closedtucked / untucked

03 · Specifications

Straightforward by default.

ModelAsync jobPOST returns a jobId in ~1 second; the image comes back once you poll it complete.
Rate limit20 req / 5 minPer API key. Over that, 429 with a Retry-After header.
Image formatsJPEG, PNG, WebPUp to 8MB per image.
Failed jobsNever billedA failed generation costs you nothing, safe to let customers retry.
AuthBearer tokenOne header, one key, created from your dashboard.

Developer API Pricing

Simple pricing. Pay per try-on. 7 day free trial.

For developers building a custom integration. Installing on Shopify? Plans are selected inside the Shopify App Store listing.

Not sure what this means for your store? See what Corlen could add to your revenue.

Starter

$49.99 / month

250 Try-Ons to start. Add as many as you want for $0.20 a try-on.

Features

  • 100 Try-Ons
  • WhatsApp Share Integration
Get started

7-day free trial

Growth

$149.00 / month

1,000 Try-Ons to start. Add as many as you want for just $0.16 a try-on.

Features

  • 500 Try-Ons
  • Full customization & embed capabilities
  • Priority customer support
  • Dev docs and custom events
  • WhatsApp Share Integration
Get started

7-day free trial

Scale

$399.00 / month

3,000 Try-Ons to start. Add as many as you want for $0.12 a try-on.

Features

  • Priority image generation
  • Dedicated technical support
  • Customer success manager
  • Full customization & embed capabilities
  • Dedicated server
  • Dev docs and custom events
  • WhatsApp Share Integration
Get started

7-day free trial

Enterprise

Custom

Custom try-on volume, built around your store's real traffic.

Features

  • Custom integration
  • Dedicated account manager
  • SLA guarantee
  • Full customization & embed capabilities
  • WhatsApp Share Integration
Contact us

Second opinion

Comparing your options?

Read an honest buyer's guide to virtual try-on apps, or ask an AI directly:

Ask ChatGPT ↗Ask Claude ↗Ask Perplexity ↗

FAQ

Developer questions, answered.

How do I get API access?

Sign up for a free trial: 7 days, 10 generations, no credit card required. Create a key from your dashboard and you can make your first call within minutes.

How does billing work?

Pay-as-you-go against your plan's included monthly generations. Going over that returns a 402 until you buy a one-time top-up pack. Failed generations are never billed.

How long does a generation take?

Typically 10 to 15 seconds for a single garment. A combo look (multiple garments in one look) takes longer since more is being generated at once.

Can I combine multiple garments in one look?

Yes, POST /api/v1/tryon/combo takes 2 to 4 garments (say, a top, a jacket, and jeans) and returns one finished look.

Your first result, in a few minutes.

Free trial, no credit card, real generations from your own catalog.

Get API keysRead the docs