Documentação da API Kleiders
Integre a geração de moda por inteligência artificial, a conversão de esboços em moldes vetoriais e a exportação CAD diretamente nos seus sistemas de confeção.
Visão Geral da API
A API da Kleiders permite automatizar integralmente o ciclo de design de moda e modelagem: desde a conceptualização visual orientada por texto até ao descarregamento de ficheiros CAD vetoriais preparados para corte fabril.
Todos os pedidos são processados via chamadas HTTP padrão, com corpos de requisição e resposta estruturados em formato JSON.
1. Obtenha a sua Chave API
Gere a sua chave secreta no painel de definições da sua conta Kleiders com um plano elegível.
2. Efetue o seu Primeiro Pedido
Realize uma chamada POST autenticada a qualquer um dos nossos endpoints para conceber um artigo ou gerar a respetiva modelagem.
3. Descarregue os Ficheiros Técnicos
Receba hiperligações seguras para transferência de ficheiros DXF (AAMA/ASTM), SVG paramétricos e fichas técnicas em PDF.
Autenticação
A autenticação é concretizada através de tokens Bearer no cabeçalho HTTP Authorization em cada pedido:
Certifique-se de que preserva a sua chave API salvaguardada em variáveis de ambiente no 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
}'Segurança de Credenciais:
Nunca inclua as suas chaves API em código executado no cliente ou em repositórios de código acessíveis ao público.
Limites de Débito de Pedidos
A tolerância volumétrica de pedidos varia segundo o plano de subscrição:
| Plano | Texto para Imagem | Esboço para Realista | Exportação de Moldes | Limite 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 |
Para limites superiores orientados a grandes cadências de produção, contacte-nos para um plano Enterprise.
Endpoint: Texto para Imagem
Gere conceitos fotorrealistas de moda a partir de instruções descritivas em linguagem natural.
Endpoint
Parâmetros
promptstringObrigatórioNatural language description of the garment to generate.modestringObrigatório"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: Esboço para Realista
Converta ilustrações à mão ou traços vetoriais em imagens de alta definição vestidas em modelos virtuais.
Endpoint
Parâmetros
modestringObrigatório"sketch-to-realistic" for this endpoint.imagefileObrigatórioSource 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: Exportação de Moldes CAD
Crie e exporte peças de molde 2D com margens de costura, fios do tecido e gradação em múltiplos tamanhos.
Endpoint
Parâmetros
generation_idstringObrigatórioThe ID of the generation to export patterns from.formatstringObrigatório"svg", "dxf", or "pdf".measurementsobjectObrigatórioBody 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
Receba avisos instantâneos quando processos complexos, como o encaixe de corte ou simulações 3D, estiverem finalizados.
Defina os seus endpoints de receção e valide a assinatura criptográfica HMAC enviada em cada evento.
Eventos Disponíveis
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 Oficiais
Dispomos de bibliotecas para Node.js, Python e TypeScript para acelerar a sua implementação.
Node.js / TypeScript
Stablenpm install @kleiders/sdkPython
Stablepip install kleidersRuby
Betagem install kleidersGo
Coming Soongo get github.com/kleiders/kleiders-goPronto para Desenvolver?
Consulte o nosso guia detalhado ou esclareça as suas questões técnicas diretamente com os nossos engenheiros.