Get Amora live in minutes.

Install the Amora app from the Shopify App Store

Search for Amora VTO in the Shopify App Store and click Add app. You'll be redirected back to your Shopify admin with Amora in the sidebar.

Open the Shopify App Store

Connect your API Key in the app settings

In the Amora Shopify app go to Settings and paste your API Key. This links your Shopify store to your Amora account for billing and analytics. You'll find your key in the Amora dashboard after signing up.

Enable VTO on your products

In the app go to Products and toggle VTO Enabled for each item. Virtual try-on works best with clean garment photos — flat-lay or on-model against a plain background.

Add the VTO Button block to your theme

In Shopify admin go to Online Store → Themes → Customize. Open a product page template, click Add block, then select Amora VTO Button from the App Blocks section.

Test the full flow

Visit a product page in your live store, click Try On, upload a photo, and confirm the result looks correct. Successful try-ons appear in your Analytics and History pages within seconds.

Save your credentials

Two credentials are used depending on where the request originates:

API Key — server-side only. Never expose this in browser or frontend code.

Public Token — safe for browser / storefront use.

Both are in your Amora dashboard after signup.

Generate a try-on from your server

POST to /api/tryon with your API Key. Accepts a person photo (URL or base64) and a garment image URL.

# From your server, never the browser
curl -X POST https://api.amora.ai/api/tryon \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "person_image": "https://cdn.example.com/model.jpg",
    "garment_url":  "https://cdn.yourstore.com/product.jpg",
    "category":     "upper_body",
    "quality":      "standard"
  }'

category: upper_body · lower_body · dresses · full_body

quality: standard (faster) or high (best detail)

Handle the response

On success you receive the generated image URL. Credits are only deducted for successful responses.

{
  "result_url":    "https://cdn.amora.ai/outputs/abc123.jpg",
  "job_id":        "job_9f2a1b3c",
  "duration_ms":   3420,
  "billed_amount": 1
}

Render result_url as an <img> on your product page. Processing typically takes 10–12 seconds — show a loading state while waiting.

Embed the JavaScript widget (browser-safe)

Add a Try On button to any webpage without server code. The widget uses your Public Token, which is safe to include in HTML.

<!-- Add just before </body> on your product page -->
<script
  src="https://api.amora.ai/widget.js"
  data-public-token="YOUR_PUBLIC_TOKEN"
  data-garment-url="https://cdn.yourstore.com/product.jpg"
  data-category="upper_body"
  async
></script>

Track conversion events (optional)

Send add-to-cart and purchase events to power your Analytics dashboard. Call this from the browser using your Public Token:

fetch('https://api.amora.ai/track', {
  method: 'POST',
  headers: {
    'X-Public-Token': 'YOUR_PUBLIC_TOKEN',
    'Content-Type':   'application/json',
  },
  body: JSON.stringify({
    event_type:  'add_to_cart',  // or 'purchase'
    session_id:  crypto.randomUUID(),
    product_url: window.location.href,
  }),
})