Color Change API

Recolor a garment in a photo without touching anything else — colorways from one product shot.

POST/v1/generateworkflow: change_color-v1

One endpoint serves every workflow — this page documents change_color-v1, the current version. Credits are debited at submission (1 cr standard, 3 cr pro); a failed generation is refunded automatically. Earlier versions of this endpoint, if any, keep being served under their own names.

Parameter	Value for this workflow
workflow	"change_color-v1" required
reference_image	Reference image — one public HTTPS URL.required
fields.garmenttorecreate	Garment to recolor. Which garment to recolor, e.g. "the jacket".
fields.hexcolorcode	New color. The new colour as a hex code, e.g. "#9CAF88".
ratio	auto
tier	"standard" (1 cr) or "pro" (3 cr)
webhook_url	Optional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles.

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "change_color-v1",
    "reference_image": "https://example.com/reference.jpg",
    "fields": {
      "garmenttorecreate": "the jacket",
      "hexcolorcode": "#9CAF88"
    },
    "ratio": "auto",
    "tier": "standard"
  }'

// 202 Accepted
{
  "generation_id": "3f1c9a6e-...",
  "status": "running",
  "poll": "/api/v1/generations/3f1c9a6e-..."
}

Example response

Poll /v1/generations/{id} (or receive the webhook) until the generation settles:

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "change_color",
  "status": "succeeded",
  "result": {
    "type": "image",
    "url": "https://.../result.webp",
    "thumbnail": "https://.../thumb.webp"
  }
}

Results are stored for 48 hours — copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.

Frequently asked questions

How precise is the color change?

The garment is recolored while fabric texture, shadows, model and background stay untouched — name the target color in the prompt or use a hex value.

How much does it cost?

1 credit on the standard tier, 3 on pro. Credits come with plans and packs; a failed generation is always refunded.

Other endpoints: Virtual Try-On API · AI Fashion Models API · Fashion Design API · Reimagine Model API · Swap Model API · AI Stylist API · all endpoints