Clothes color changer API

Clothes color changer API

Shoot one color and generate the rest: send the photo and a hex code, get the same photo with only that garment recolored. The fabric's sheen and folds, the print, the model and the light stay exactly as they were.

Test keys are free and need no pack.

  • An exact hex code, with an optional color name for the shade.
  • Name the garment when the photo shows several.
  • Texture, sheen, seams and print structure are kept.
Model in an ivory satin slip dress in an arched plaster room
Input
The same photo with the dress in terracotta
#c8553d
The same photo with the dress in sage green
#a3b196
POST https://api.garmo.studio/v1/edit/color
{
  "color_hex": "#c8553d",
  "color_name": "terracotta",
  "garment": "dress"
}

One request

Every request is asynchronous: the request returns a job in about two seconds, the images follow in 20 to 90 seconds by webhook or by polling.

curl https://api.garmo.studio/v1/edit/color \
  -H "Authorization: Bearer $GARMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://shop.example/products/dress-123.jpg",
    "color_hex": "#c8553d",
    "color_name": "terracotta",
    "garment": "dress"
  }'
Finished job · GET /jobs/{id}
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "color",
  "status": "completed",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "succeeded",
      "label": "dress · terracotta",
      "url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…0.webp?X-Amz-Signature=…",
      "url_expires_at": "2026-11-20T14:00:00Z"
    }
  ],
  "credits_charged": 1,
  "credits_refunded": 0,
  "metadata": {
    "sku": "DR-123"
  },
  "created_at": "2026-11-19T14:02:11Z",
  "completed_at": "2026-11-19T14:02:58Z"
}

Parameters

color_hexThe new color, like "#c8553d".
color_nameA name for the color (up to 40 characters); helps with shades a hex alone leaves open.
garmentWhich garment to recolor when there are several, like "dress" or "jacket".
Full reference

Cost

1 credit

1 API credit = 1 image. Failed and canceled images are refunded automatically.

API pricing

What people build with it

Variant images

One image per color variant in the catalog, made the moment the variant is created.

Pre-orders

Show a colorway before the sample exists.

Color tests

Try a palette on a bestseller before ordering fabric.

Prefer to click? Use it in Garmo Studio →

Good to know

Questions, answered.

What developers ask before connecting Garmo to a shop or a workflow.

Still stuck? Email us

How exact is the color?

The garment is recolored to the hex you send, then lit by the photo's own light, so it reads as that color in that room. Add color_name for shades a hex leaves open.

Can I recolor several colors at once?

Send one request per color. Each request returns one image and costs one credit; requests run in parallel within your plan's limits.

Which garment is changed?

The main garment, or the one you name in garment, like "jacket" when the photo shows a jacket and a shirt.

Other edits in the API

Get an API key

Test keys are free and need no pack.