Quickstart

You need an API key from platform.genlook.app (3 free credits on signup), a customer photo and a product image URL.

On TypeScript, use the @genlook/api SDK. It does these three steps in three lines.

1. Upload the customer photo

curl -X POST "https://api.genlook.app/tryon/v1/images/upload" \
  -H "x-api-key: gk_your_api_key" \
  -F "file=@customer.jpg"

import requests

BASE = "https://api.genlook.app/tryon/v1"
headers = {"x-api-key": "gk_your_api_key"}

with open("customer.jpg", "rb") as f:
    r = requests.post(f"{BASE}/images/upload", headers=headers,
                      files={"file": ("customer.jpg", f, "image/jpeg")})
r.raise_for_status()
image_id = r.json()["imageId"]

const form = new FormData();
form.append("file", customerPhoto);
const { imageId } = await fetch("https://api.genlook.app/tryon/v1/images/upload", {
  method: "POST",
  headers: { "x-api-key": API_KEY },
  body: form,
}).then((r) => r.json());

Keep the imageId. It works for every try-on on this photo until it expires (7 days by default).

2. Create the try-on

curl -X POST "https://api.genlook.app/tryon/v1/try-on" \
  -H "x-api-key: gk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "externalId": "shirt-42",
      "title": "Red cotton t-shirt",
      "description": "Regular fit crew neck tee in soft cotton, short sleeves, hip length.",
      "images": [{ "source": { "url": "https://cdn.example.com/red-tee.jpg" } }]
    }],
    "person": { "image": { "source": { "id": "<imageId>" } } }
  }'

r = requests.post(f"{BASE}/try-on", headers=headers, json={
    "products": [{
        "externalId": "shirt-42",
        "title": "Red cotton t-shirt",
        "description": "Regular fit crew neck tee in soft cotton, short sleeves, hip length.",
        "images": [{"source": {"url": "https://cdn.example.com/red-tee.jpg"}}],
    }],
    "person": {"image": {"source": {"id": image_id}}},
})
r.raise_for_status()
generation_id = r.json()["generationId"]

const { generationId } = await fetch("https://api.genlook.app/tryon/v1/try-on", {
  method: "POST",
  headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    products: [{
      externalId: "shirt-42",
      title: "Red cotton t-shirt",
      description: "Regular fit crew neck tee in soft cotton, short sleeves, hip length.",
      images: [{ source: { url: "https://cdn.example.com/red-tee.jpg" } }],
    }],
    person: { image: { source: { id: imageId } } },
  }),
}).then((r) => r.json());

This creates the product shirt-42. For every next try-on, send only { "externalId": "shirt-42" }. The product is already analyzed, so the result comes back faster.

3. Get the result

Python

import time

while True:
    data = requests.get(f"{BASE}/generations/{generation_id}", headers=headers).json()
    if data["status"] == "COMPLETED":
        print(data["resultImageUrl"])
        break
    if data["status"] == "FAILED":
        raise RuntimeError(data["errorCode"], data["errorMessage"])
    time.sleep(1)

Results take about 10 seconds. resultImageUrl is temporary: display or download it right away, or fetch the generation again for a fresh URL.

Create Try-On: every option (image sources, crop, retention, watermark).
Full example: production pattern with PRODUCT_NOT_FOUND handling.
Next.js example app: a working integration to clone.

Get Started

Guides

Try-On

Products (optional)

Account

Releases

1. Upload the customer photo

2. Create the try-on

3. Get the result

Next

​1. Upload the customer photo

​2. Create the try-on

​3. Get the result

​Next

1. Upload the customer photo

2. Create the try-on

3. Get the result

Next