Documentación de la API de Kleiders
Integra la generación de conceptos de moda con IA, la conversión de bocetos a patrones vectoriales y la exportación de archivos CAD directamente en tus sistemas de confección.
Visión General de la API
La API de Kleiders te permite automatizar el ciclo completo de diseño de moda y patronaje: desde la conceptualización visual basada en lenguaje natural hasta la descarga de archivos CAD vectoriales listos para el corte textil.
Todas las solicitudes se realizan mediante peticiones HTTP estándar utilizando JSON para los cuerpos de solicitud y respuesta.
1. Obtén tu Clave API
Genera tu clave secreta desde el panel de configuración de tu cuenta Kleiders con un plan compatible.
2. Envía tu Primera Solicitud
Realiza una llamada POST autenticada a cualquiera de nuestros endpoints para generar una prenda o extraer su moldería.
3. Descarga tus Archivos Técnicos
Recibe enlaces seguros para descargar archivos DXF (AAMA/ASTM), SVG paramétricos y fichas técnicas en PDF.
Autenticación
La autenticación se realiza mediante tokens Bearer en la cabecera HTTP Authorization de cada petición:
Asegúrate de mantener tu clave API protegida en variables de entorno del servidor.
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
}'Seguridad de Claves:
Nunca expongas tus claves API en código del lado del cliente ni en repositorios públicos de código.
Límites de Tasa de Peticiones
Los límites de peticiones varían en función de tu plan de suscripción:
| Plan | Texto a Imagen | Boceto a Realista | Exportación de Patrones | Límite por Minuto |
|---|---|---|---|---|
| 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 |
Si necesitas límites superiores para producción en masa, contacta con nuestro equipo para un plan Enterprise.
Endpoint: Texto a Imagen
Genera conceptos de moda fotorrealistas a partir de descripciones en lenguaje natural.
Endpoint
Parámetros
promptstringObligatorioNatural language description of the garment to generate.modestringObligatorio"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 }, ...]Endpoint: Boceto a Realista
Transforma bocetos o dibujos vectoriales en imágenes hiperrealistas con prendas vestidas en avatares.
Endpoint
Parámetros
modestringObligatorio"sketch-to-realistic" for this endpoint.imagefileObligatorioSource 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);Endpoint: Exportación de Patrones CAD
Genera y exporta la moldería 2D con márgenes de costura, líneas de hilo y escalado multitalle.
Endpoint
Parámetros
generation_idstringObligatorioThe ID of the generation to export patterns from.formatstringObligatorio"svg", "dxf", or "pdf".measurementsobjectObligatorioBody 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", ... }]AAMA 292 / ASTM D6673 CAD Export
Kleiders natively compiles pattern geometry into industry-standard ASTM D6673 / AAMA 292 (AutoCAD R12) format. Simply export from Pattern Studio and drag & drop directly into CLO 3D, Marvelous Designer, Gerber AccuMark, or Lectra Modaris.
ASTM D6673 / AAMA 292 CAD Layer Specification
Layer 1Cut BoundaryWhiteOuter pattern perimeter; converted to AutoCAD R12 closed polylines to eliminate spline truncation.Layer 8Sew LinesCyanNet seamlines representing finished garment seam contours and net stitching.Layer 4GrainlineMagentaFabric warp grain alignment with directional orientation.Layer 13NotchesRed5mm slit notches for automated pattern piece registration.Layer 15Drill HolesOrangeDart apex markers and pocket/button placement drill points.Layer 7MetadataYellowPiece name, style name, size, quantity, and fabric specification.Webhooks
Recibe notificaciones en tiempo real cuando tareas de computación intensiva como el anidado de corte o la exportación 3D se hayan completado.
Configura tus endpoints receptores y valida la firma HMAC enviada en cada payload.
Eventos Disponibles
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: { ... } }
}SDKs Oficiales
Contamos con librerías para Node.js, Python y TypeScript para acelerar tu desarrollo.
Node.js / TypeScript
Stablenpm install @kleiders/sdkPython
Stablepip install kleidersRuby
Betagem install kleidersGo
Coming Soongo get github.com/kleiders/kleiders-go¿Listo para Construir?
Consulta nuestra guía paso a paso o contacta con nuestros ingenieros para resolver dudas de integración.