TypeScript SDK

pnpm add @genlook/api

import { Genlook } from "@genlook/api";
import { readFile } from "node:fs/promises";

const client = new Genlook({ apiKey: process.env.GENLOOK_API_KEY! });

// 1. Upload the customer photo. Reuse imageId for every try-on on this photo.
const { imageId } = await client.images.upload(await readFile("./customer.jpg"), {
  mimeType: "image/jpeg",
});

// 2. Run the try-on and get the result in the same request.
// The product is created or updated inline.
const result = await client.tryOn.createSync({
  products: [{
    externalId: "hoodie-42",
    title: "Oversized cotton hoodie",
    description: "Relaxed-fit hoodie in heavyweight cotton, dropped shoulders, ribbed cuffs, hip length.",
    images: [{ source: { url: "https://cdn.example.com/hoodie.jpg" } }],
  }],
  person: { image: { source: { id: imageId } } },
});

// Usually COMPLETED. If it took longer than the 90 s the server waits, poll it.
const done =
  result.status === "COMPLETED" ? result : await client.generations.waitFor(result.generationId);
console.log(done.resultImageUrl);

await client.tryOn.create(input, { signal: AbortSignal.timeout(10_000) });

const result = await client.generations.waitFor(generationId, {
  timeoutMs: 180_000,                     // default 3 min
  signal: controller.signal,              // optional cancel
  onStatus: (s) => console.log(s.status), // called on every poll
});

import { GenlookError, ProductNotFoundError, InsufficientCreditsError } from "@genlook/api";

try {
  await client.tryOn.create({
    products: [{ externalId: "hoodie-42" }],
    person: { image: { source: { id: imageId } } },
  });
} catch (err) {
  if (err instanceof ProductNotFoundError) {
    // Expired or never created: resend the product inline.
  } else if (err instanceof InsufficientCreditsError) {
    // Ask the user to top up.
  } else if (err instanceof GenlookError) {
    console.error(err.code, err.message, err.requestId);
  } else throw err;
}

import { createReadStream } from "node:fs";

const { imageId } = await client.images.upload(createReadStream("./customer.heic"), {
  filename: "customer.heic",
  mimeType: "image/heic",
  crop: true,                 // 4:5 crop around the person (default). false keeps the framing.
  externalUserId: "user-123", // your user id, for GDPR deletion. No PII.
  keepForDays: 7,             // 1, 3 or 7
});

await client.tryOn.create({
  products: [{ externalId: "shirt-42", title: "Red tee", images: [{ source: { fileKey: "front" } }] }],
  person: { image: { source: { id: imageId } } },
  files: { front: { data: await readFile("./front.jpg"), mimeType: "image/jpeg" } },
});

for await (const product of client.products.iterate()) {
  console.log(product.externalId);
}