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.



{
"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"
}'const r = await fetch("https://api.garmo.studio/v1/edit/color", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GARMO_API_KEY}`,
"Idempotency-Key": "order-123-color",
"Content-Type": "application/json",
},
body: JSON.stringify({"image_url": "https://shop.example/products/dress-123.jpg", "color_hex": "#c8553d", "color_name": "terracotta", "garment": "dress"}),
});
const job = await r.json();
console.log(job.id, job.status);import os, requests
r = requests.post(
"https://api.garmo.studio/v1/edit/color",
headers={"Authorization": f"Bearer {os.environ['GARMO_API_KEY']}", "Idempotency-Key": "order-123-color"},
json={
"image_url": "https://shop.example/products/dress-123.jpg",
"color_hex": "#c8553d",
"color_name": "terracotta",
"garment": "dress",
},
)
job = r.json()
print(job["id"], job["status"])<?php
$ch = curl_init("https://api.garmo.studio/v1/edit/color");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode(["image_url" => "https://shop.example/products/dress-123.jpg", "color_hex" => "#c8553d", "color_name" => "terracotta", "garment" => "dress"]),
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GARMO_API_KEY"), "Idempotency-Key: order-123-color", "Content-Type: application/json"],
]);
$job = json_decode(curl_exec($ch), true);
echo $job["id"], " ", $job["status"];require "net/http"
require "json"
uri = URI("https://api.garmo.studio/v1/edit/color")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("GARMO_API_KEY")}"
req["Idempotency-Key"] = "order-123-color"
req["Content-Type"] = "application/json"
req.body = <<~'JSON'
{
"image_url": "https://shop.example/products/dress-123.jpg",
"color_hex": "#c8553d",
"color_name": "terracotta",
"garment": "dress"
}
JSON
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
job = JSON.parse(res.body)
puts job["id"], job["status"]package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"image_url": "https://shop.example/products/dress-123.jpg",
"color_hex": "#c8553d",
"color_name": "terracotta",
"garment": "dress"
}`)
req, _ := http.NewRequest("POST", "https://api.garmo.studio/v1/edit/color", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("GARMO_API_KEY"))
req.Header.Set("Idempotency-Key", "order-123-color")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Garmo {
public static void main(String[] args) throws Exception {
String body = """
{
"image_url": "https://shop.example/products/dress-123.jpg",
"color_hex": "#c8553d",
"color_name": "terracotta",
"garment": "dress"
}
""";
HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.garmo.studio/v1/edit/color"))
.header("Authorization", "Bearer " + System.getenv("GARMO_API_KEY"))
.header("Idempotency-Key", "order-123-color")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.statusCode() + " " + res.body());
}
}{
"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_hex | The new color, like "#c8553d". |
color_name | A name for the color (up to 40 characters); helps with shades a hex alone leaves open. |
garment | Which garment to recolor when there are several, like "dress" or "jacket". |
Cost
1 credit
1 API credit = 1 image. Failed and canceled images are refunded automatically.
API pricingWhat 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.
Questions, answered.
What developers ask before connecting Garmo to a shop or a workflow.
Still stuck? Email usHow 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
POST /generatePose changer APIThe back view and the walking shot from one photo.POST /edit/poseModel swap APIThe same outfit and pose on another model.POST /edit/model-swapGhost mannequin APIThe invisible-mannequin shot, without the mannequin.POST /edit/ghost-mannequinBackground changer APIKeep the subject, change the place, match the light.POST /edit/backgroundBackground remover APICut out products onto transparent, white or a brand color.POST /edit/remove-backgroundImage upscaler API2K or 4K product photos with real material detail.POST /edit/upscaleGet an API key
Test keys are free and need no pack.




