Mirrago API — Introduction

Mirrago is a Virtual Try-On generation API for fashion businesses. It allows you to generate realistic try-on images by combining a model image with a garment image using an integration that’s intentionally simple and scalable.

With Mirrago, you can:

• Add try-on experiences to product pages and campaigns
• Run batch generation workflows at scale

Why Mirrago

Minimal integration surface

You only need two endpoints:

1. Create a try-on job: POST /v1/mirrago/generate-image
2. Retrieve job status + result: GET /v1/mirrago/job/{{job_id}}

Asynchronous by design

Generation is handled as a job, which means:

• Your app stays responsive
• You can scale throughput
• You can poll for completion or plug in webhooks later

Business-ready

Mirrago is designed for B2B use cases:

• Token-based authentication
• Usage-based billing (credits per generation)
• Reliable job tracking (queued → processing → completed/failed)

---

How it works

1. Send input images
   Provide a public URL to the model image and garment image.

2. Receive a job ID
   Mirrago responds immediately with a job_id.

3. Check status
   Poll job status until the job is completed.

4. Render the result
   Display the returned result_url in your UI.

---

Typical flow

Step 1 — Create Job

POST /v1/mirrago/generate-image
→ Returns { job_id }

Step 2 — Poll Status

GET /v1/mirrago/job/{job_id}
→ Returns { status: completed, result_image_url }

---