Analyze Design

Analyze a design image for color count, complexity, and recommended print technique.

This endpoint is free — no tokens required.

Endpoint

POST https://garmint.app/api/v1/analyze

Request Body

imageUrl

string

URL of the design image to analyze. Must be publicly accessible.

imageData

string

Base64-encoded image data. Use this for direct uploads.

quantity

number

default:"50"

Target print quantity for pricing estimates (1-10,000).

Provide either imageUrl OR imageData, not both.

Response

colors

object

Color analysis results.

Show Colors properties

count

number

Total number of distinct colors detected.

dominant

array

Top 5 dominant colors as hex values.

pantone

array

Closest Pantone color matches (if available).

dimensions

object

Image dimension analysis.

Show Dimensions properties

width

number

Image width in pixels.

height

number

Image height in pixels.

aspectRatio

number

Width/height ratio.

hasTransparency

boolean

Whether the image has transparent areas.

recommendation

object

Print technique recommendation.

Show Recommendation properties

technique

string

Recommended technique: dtg, screen, embroidery, or vinyl.

reason

string

Explanation for the recommendation.

complexity

string

Design complexity: simple, moderate, or complex.

pricing

object

Estimated pricing by technique.

Show Pricing properties

dtg

object

DTG (Direct-to-Garment) pricing.

screen

object

Screen printing pricing (includes setup cost).

warnings

array

Array of potential issues detected.

Example

curl -X POST https://garmint.app/api/v1/analyze \
  -H "Authorization: Bearer gm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/my-design.png",
    "quantity": 100
  }'

Response Example

{
  "colors": {
    "count": 5,
    "dominant": ["#1a1a1a", "#ff6b6b", "#4ecdc4", "#ffffff", "#2c3e50"],
    "pantone": ["Black C", "Warm Red C", "3242 C"]
  },
  "dimensions": {
    "width": 2400,
    "height": 3000,
    "aspectRatio": 0.8,
    "hasTransparency": true
  },
  "recommendation": {
    "technique": "dtg",
    "reason": "Design has 5 colors with gradients - DTG handles color complexity well",
    "complexity": "moderate"
  },
  "pricing": {
    "dtg": {
      "perUnit": 8.50,
      "currency": "USD"
    },
    "screen": {
      "perUnit": 4.25,
      "setup": 125.00,
      "minimumQuantity": 24,
      "currency": "USD"
    }
  },
  "warnings": [
    "Design has significant transparency - consider the garment color"
  ]
}

Use Cases

Pre-flight Check

Run analysis before generation to catch issues:

async function validateDesign(designUrl: string) {
  const analysis = await analyzeDesign(designUrl);
  
  if (analysis.colors.count > 12) {
    console.warn('High color count may increase costs');
  }
  
  if (analysis.dimensions.width < 1000) {
    throw new Error('Design resolution too low for quality print');
  }
  
  if (analysis.warnings.length > 0) {
    console.warn('Warnings:', analysis.warnings);
  }
  
  return analysis;
}

Dynamic Pricing

Use analysis to show customers estimated costs:

function calculateQuote(analysis: AnalysisResult, quantity: number) {
  const { pricing } = analysis;
  
  // Compare DTG vs Screen for this quantity
  const dtgTotal = pricing.dtg.perUnit * quantity;
  const screenTotal = pricing.screen.setup + (pricing.screen.perUnit * quantity);
  
  return {
    dtg: { total: dtgTotal, perUnit: pricing.dtg.perUnit },
    screen: { total: screenTotal, perUnit: screenTotal / quantity },
    recommended: quantity >= 50 ? 'screen' : 'dtg',
  };
}

Print Technique Guide

Technique	Best For	Color Limit
DTG	Full-color, photos, gradients	Unlimited
Screen	Simple designs, large runs	1-8 colors
Embroidery	Logos, text, premium look	1-15 colors
Vinyl	Names, numbers, simple shapes	1-3 colors

Getting Started

Endpoints

Analyze Design

Analyze Design

Endpoint

Request Body

Response

Example

Response Example

Use Cases

Pre-flight Check

Dynamic Pricing

Print Technique Guide

Getting Started

Endpoints

​Analyze Design

​Endpoint

​Request Body

​Response

​Example

​Response Example

​Use Cases

​Pre-flight Check

​Dynamic Pricing

​Print Technique Guide

Analyze Design

Endpoint

Request Body

Response

Example

Response Example

Use Cases

Pre-flight Check

Dynamic Pricing

Print Technique Guide