Garment color match

POST /v1/color/garment · $0.01 a call

Send a photo of a clothing item and the wearer's season from the color API. A vision model finds the garment's main colors and marks a clean patch of each. Truelens measures those colors from the pixels, converts them to CIELAB, and finds the closest color to wear and the closest color to avoid in the season's fixed palette. The verdict comes from those distances, so the same photo always gets the same answer.

For styling and outfit apps, wardrobe apps, shopping assistants.

Request

Send the photo as image (multipart), image_base64 or image_url, as described in the overview. These fields go alongside it:

Field	Type	Description
`season`	one of light_spring, warm_spring, bright_spring, light_summer, cool_summer, soft_summer, soft_autumn, warm_autumn, deep_autumn, deep_winter, cool_winter, bright_winter, required	The wearer's color season id, as returned by the color API.

Photo tips. Lay the item flat or hang it in daylight from a window, filling most of the frame. No flash, no filter. JPEG gives measured colors; other formats fall back to estimates.

1curl https://truelens.keronlabs.com/v1/color/garment \
2  -H "Authorization: Bearer $TRUELENS_KEY" \
3  -F image=@portrait.jpg \
4  -F season="soft_autumn"

Response

Field	Description
`summary`	One line, e.g. "Great for Soft Autumn: teal blue, close to Teal".
`verdict`	great, good, okay or avoid, for the garment's main color.
`season`	The season id and name the garment was judged for.
`garment`	What the garment is, in a few words.
`closest_best`	The nearest color to wear in the palette (best colors and neutrals): name, hex and delta_e, the color distance.
`closest_avoid`	The nearest color to avoid: name, hex and delta_e.
`advice`	One plain sentence on how to wear it.
`colors[]`	Each main color: name, hex, lab, share of the garment, measured (false when it is an estimate), verdict and its closest best and avoid colors.
`quality`	ok is false when the colors are estimates or the light had a cast; warnings says why.

Example

Output of this API’s own code on a sample photo. Values will differ for your photos.

1{
2  "metadata": {
3    "id": "req_9cf4da08fe7f40dab71a",
4    "engine": "color/garment",
5    "status": "success",
6    "cached": false,
7    "credits_used": 1,
8    "created_at": "2026-10-19T09:30:00.000Z",
9    "processing_ms": 3400
10  },
11  "summary": "Okay for Soft Autumn: teal blue, close to Soft teal",
12  "verdict": "okay",
13  "season": {
14    "id": "soft_autumn",
15    "name": "Soft Autumn"
16  },
17  "garment": "knitted crew neck sweater",
18  "closest_best": {
19    "name": "Soft teal",
20    "hex": "#5f9590",
21    "delta_e": 28.3
22  },
23  "closest_avoid": {
24    "name": "Black",
25    "hex": "#111111",
26    "delta_e": 46.7
27  },
28  "advice": "This teal blue is neither a Soft Autumn color nor one to avoid, so wear it away from the face or with soft teal up top.",
29  "colors": [
30    {
31      "name": "teal blue",
32      "hex": "#3a6e91",
33      "lab": {
34        "L": 44.4,
35        "a": -6.4,
36        "b": -24.4
37      },
38      "share": 0.75,
39      "measured": true,
40      "verdict": "okay",
41      "closest_best": {
42        "name": "Soft teal",
43        "hex": "#5f9590",
44        "delta_e": 28.3
45      },
46      "closest_avoid": {
47        "name": "Black",
48        "hex": "#111111",
49        "delta_e": 46.7
50      }
51    },
52    {
53      "name": "light gray",
54      "hex": "#d8d6da",
55      "lab": {
56        "L": 85.9,
57        "a": 1.4,
58        "b": -1.7
59      },
60      "share": 0.2,
61      "measured": true,
62      "verdict": "great",
63      "closest_best": {
64        "name": "Oyster",
65        "hex": "#e8dfd0",
66        "delta_e": 10.7
67      },
68      "closest_avoid": {
69        "name": "Icy blue",
70        "hex": "#d6ecff",
71        "delta_e": 12.8
72      }
73    }
74  ],
75  "quality": {
76    "ok": true,
77    "warnings": []
78  }
79}