Documentation Index

Fetch the complete documentation index at: https://docs.pixcraft.es/llms.txt

Use this file to discover all available pages before exploring further.

​

PixCraft API

​

What you can build

• Material stores — Add a pattern configurator to your product pages so customers can visualize their projects before buying.
• Crafting apps — Use PixCraft’s color-matching algorithm and pattern generation without building it from scratch.
• Automations — Connect with Zapier, Make, or n8n to automatically generate patterns when orders arrive.

​

How it works

1. Send an image (base64 or URL) to the API along with target dimensions and a niche (curtains, mosaics, LEGO, etc.)
2. The API processes the image using perceptual color matching (CIE Lab Delta E)
3. You receive a complete pattern: materials list, assembly guide, and optional PDF

​

Quick example

curl -X POST https://www.pixcraft.es/api/v1/generate \
  -H "Authorization: Bearer px_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "niche": "curtains",
    "width_cm": 200,
    "height_cm": 250,
    "max_colors": 8
  }'

{
  "success": true,
  "niche": "curtains",
  "dimensions": {
    "width_cm": 200,
    "height_cm": 250,
    "cols": 133,
    "rows": 125,
    "total_units": 16625
  },
  "materials": [
    {
      "color_id": "blanco",
      "color_name": "Blanco",
      "hex": "#FFFFFF",
      "quantity": 10804,
      "percentage": 81.2
    }
  ],
  "assembly_guide": [...],
  "usage": {
    "calls_used": 244,
    "calls_remaining": 4756
  }
}

​

Supported niches

​

Next steps