API Documentation

import Kleiders from '@kleiders/sdk';

const kld = new Kleiders({ apiKey: process.env.KLEIDERS_API_KEY });

const generation = await kld.generations.create({
  prompt: "Oversized linen shirt, sand colorway, relaxed fit",
  mode: "text-to-image",
  style: "photorealistic",
  count: 4,
  size: "1024x1024",
});

// Each result contains a high-res URL and metadata
console.log(generation.results);
// → [{ id, url, prompt, created_at, metadata }, ...]

import Kleiders from '@kleiders/sdk';
import fs from 'fs';

const kld = new Kleiders({ apiKey: process.env.KLEIDERS_API_KEY });

const sketch = fs.readFileSync('./my-sketch.png');

const generation = await kld.generations.create({
  mode: "sketch-to-realistic",
  image: sketch,               // PNG, JPG, or WebP
  prompt: "Premium silk evening gown, midnight blue",
  fidelity: "high",             // how closely to follow the sketch
  count: 2,
});

console.log(generation.results[0].url);

const pattern = await kld.patterns.export({
  generation_id: "gen_abc123",
  format: "dxf",                // "svg" | "dxf" | "pdf"
  measurements: {
    bust: 92,
    waist: 74,
    hips: 98,
    height: 170,
    unit: "cm",
  },
  seam_allowance: 1.5,          // centimeters
  include_grading: true,         // generate size range S–XL
});

// Download the production-ready pattern file
console.log(pattern.download_url);
console.log(pattern.pieces);
// → [{ name: "Front Bodice", ... }, { name: "Back Panel", ... }]

// POST https://api.kleiders.com/v1/webhooks
const webhook = await kld.webhooks.create({
  url: "https://yourapp.com/api/kleiders-webhook",
  events: [
    "generation.completed",
    "generation.failed",
    "pattern.exported",
  ],
  secret: "whsec_your_signing_secret",
});

// Verify incoming webhook signatures
import { verifyWebhookSignature } from '@kleiders/sdk';

export async function POST(req) {
  const payload = await req.text();
  const signature = req.headers.get('x-kleiders-signature');

  const event = verifyWebhookSignature(payload, signature, secret);
  // → { type: "generation.completed", data: { ... } }
}