Documentazione API
Integra il motore di design AI di Kleiders nelle tue applicazioni. Genera design fotorealistici, trasforma schizzi ed esporta cartamodelli pronti per la produzione — tutto tramite una semplice API REST.
Panoramica
L'API di Kleiders ti offre l'accesso programmatico alla nostra piattaforma di design di moda AI. Con poche chiamate API, puoi generare immagini fotorealistiche di indumenti da descrizioni di testo, trasformare schizzi abbozzati in visualizzazioni pronte per la produzione, ed esportare cartamodelli scalati su misure corporee personalizzate.
L'API è basata su principi REST standard. Tutte le richieste utilizzano JSON, le risposte includono paginazione e dettagli sugli errori, e l'autenticazione è gestita tramite token bearer. Ogni generazione è immutabile e recuperabile — una volta creati, i tuoi design sono archiviati permanentemente e referenziabili tramite il loro ID univoco.
Ottieni la tua chiave API
Genera una chiave dalle impostazioni della dashboard. Disponibile dal piano Studio in su.
Effettua la tua prima chiamata
Invia un prompt di testo all'endpoint di generazione e ricevi immagini di design in pochi secondi.
Esporta cartamodelli
Converti qualsiasi generazione in file modello DXF, SVG o PDF con misure personalizzate.
Autenticazione
Tutte le richieste API richiedono una chiave API valida inviata tramite l'header Authorization come token Bearer. Le chiavi API iniziano con kld_live_ per la produzione e kld_test_ per gli ambienti sandbox.
Puoi generare e gestire le chiavi API dalla tua Dashboard → Impostazioni → Chiavi API. Ogni chiave può essere limitata a specifici permessi (sola lettura, generazione, esportazione) e può essere revocata in qualsiasi momento.
curl https://api.kleiders.com/v1/generations \
-H "Authorization: Bearer kld_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A tailored navy wool blazer with peak lapels",
"mode": "text-to-image",
"count": 4
}'Mantieni le tue chiavi al sicuro
Non esporre mai le chiavi API in codice client-side o in repository pubblici. Utilizza variabili d'ambiente e route API server-side. Se una chiave è compromessa, revocala immediatamente dalla dashboard.
Limiti di Richiesta (Rate Limits)
I limiti di richiesta proteggono la piattaforma e garantiscono un uso equo tra tutti gli utenti. I limiti vengono applicati per chiave API e si azzerano all'inizio di ogni mese (UTC). Quando superi un limite, l'API risponde con uno stato 429 Too Many Requests e include un header Retry-After.
| Piano | Testo-Immagine | Schizzo-a-Realistico | Esportazioni Cartamodelli | Frequenza |
|---|---|---|---|---|
| Free Trial | 5 total | 1 total | — | 5 req/min |
| Starter | 250/mo | 50/mo | 100/mo | 30 req/min |
| Serious Founder | 1,250/mo | 250/mo | 300/mo | 60 req/min |
| Studio | 5,000/mo | 800/mo | Unlimited | 120 req/min |
| Enterprise | Custom | Custom | Unlimited | Custom |
Gli header di risposta includono X-RateLimit-Remaining e X-RateLimit-Reset così puoi monitorare l'utilizzo programmaticamente.
Testo-Immagine
Genera immagini fotorealistiche da descrizioni in linguaggio naturale. Il modello comprende tipi di tessuto, silhouette, colori, vestibilità e contesto stilistico per produrre concetti di design ad alta fedeltà.
Endpoint
Parametri
promptstringObbligatorioNatural language description of the garment to generate.modestringObbligatorio"text-to-image" for this endpoint.stylestring"photorealistic" (default), "editorial", "technical-flat", or "mood-board".countintegerNumber of variations to generate (1–8). Default: 4.sizestringOutput resolution: "512x512", "1024x1024" (default), or "2048x2048".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 }, ...]Schizzo-a-Realistico
Carica uno schizzo a mano, un'illustrazione o una moodboard e trasformala in una visualizzazione fotorealistica. Aggiungi un prompt di testo per guidare le scelte del tessuto, lo stile e le varianti colore.
Endpoint
Parametri
modestringObbligatorio"sketch-to-realistic" for this endpoint.imagefileObbligatorioSource sketch image (PNG, JPG, WebP). Max 10MB.promptstringOptional text guidance for fabric, color, and styling.fidelitystring"low", "medium" (default), or "high" — how closely to follow the sketch.countintegerNumber of variations (1–4). Default: 2.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);Esportazione Cartamodelli
Converti qualsiasi design generato in file per la produzione. Fornisci misure corporee e il motore produrrà cartamodelli sviluppati in taglia nel tuo formato CAD preferito, completi di margini di cucitura, drittofilo ed etichettatura dei pezzi.
Endpoint
Parametri
generation_idstringObbligatorioThe ID of the generation to export patterns from.formatstringObbligatorio"svg", "dxf", or "pdf".measurementsobjectObbligatorioBody measurements: bust, waist, hips, height, and unit ("cm" or "in").seam_allowancenumberSeam allowance in the measurement unit. Default: 1.5cm.include_gradingbooleanGenerate a full size range (XS–XL). Default: false.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", ... }]Webhook
Ricevi notifiche in tempo reale quando le generazioni sono completate, i cartamodelli vengono esportati o si verificano errori. I webhook eliminano la necessità di interrogazioni (polling) e consentono un'integrazione fluida con i tuoi flussi di lavoro interni.
Tutti i payload dei webhook sono firmati con HMAC-SHA256 usando il segreto del tuo webhook. Verifica sempre le firme prima di elaborare gli eventi per prevenire lo spoofing.
Eventi Disponibili
generation.completedFired when an AI generation finishes processing and images are ready.generation.failedFired when a generation fails due to content policy, timeout, or server error.pattern.exportedFired when a pattern export has completed and the file is ready for download.usage.thresholdFired when API usage reaches 80% or 100% of your plan limit.// 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: { ... } }
}SDK e Librerie
Librerie client ufficiali che gestiscono autenticazione, tentativi, paginazione e sicurezza dei tipi in modo nativo. Installa il tuo SDK preferito e inizia a costruire in pochi minuti.
Node.js / TypeScript
Stablenpm install @kleiders/sdkPython
Stablepip install kleidersRuby
Betagem install kleidersGo
Coming Soongo get github.com/kleiders/kleiders-goPronto per costruire?
L'accesso API è disponibile dal piano Studio in su. Ottieni la tua chiave API e inizia a integrare Kleiders nel tuo flusso di lavoro di design oggi stesso.