---
title: "Product Color Change"
method: POST
path: "/v2/tool/colorways"
tags: ["edit-workflow"]
---

# Product Color Change

`POST /v2/tool/colorways`

Recolors the masked regions of the product photo, each to its own
target color, while preserving the product's geometry, materials,
prints, logos, and shading, and keeping every region outside the
masks unchanged.

The request is processed asynchronously. Poll
`GET /v1/generations/{generation_id}` with the returned `generation_id`
until the generation is completed or failed.

Supply the product photo as raw `image` bytes via
`multipart/form-data`.

Supply the masks marking the regions to recolor as raw `masks` bytes,
paired by position with `colors` — up to 4 regions; a single-region
edit is a one-item list. Every mask must have the same pixel
dimensions as the product photo. White pixels mark the region to
recolor; black pixels are preserved. Alpha-only masks are also
supported: opaque pixels mark the region to recolor and transparent
pixels are preserved.

## Headers

- `Api-Key` string, required

## Response `200`

Colorway accepted for asynchronous processing.

- ColorwaysResponse — Acknowledgement that the colorway was accepted. Poll `GET /v1/generations/{generation_id}` for status and results.
  - `generation_id` string, required — URL-safe base64 ID accepted by the generation polling endpoint.

## Other responses

- `400` — Invalid input provided.
- `401` — Unauthorized.
- `402` — Insufficient credits or quota.
- `403` — Not authorized to create a colorway.
- `429` — Too many requests.

---

[API](https://skmtc.dev/ideogram/apis/api-reference.md) · [All operations](https://skmtc.dev/ideogram/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/api-reference/revisions/d4cec35f719f/schema)