Ghost mannequin API

Ghost mannequin API for clothing photos

Send a garment photographed on a person, a mannequin, a hanger or a bed, get back the clean invisible-mannequin shot: the garment on its own with the shape it has when worn and the inside of the back neckline showing.

Test keys are free and need no pack.

  • From a model, mannequin, hanger or flat photo.
  • Hollow 3D shape with the inside of the neckline.
  • A background of your choice in a few words.
A light blue oxford shirt laid out on an unmade bed
Input
The same shirt as a ghost mannequin product photo
light grey studio
POST https://api.garmo.studio/v1/edit/ghost-mannequin
{
  "background": "light grey studio"
}

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/ghost-mannequin \
  -H "Authorization: Bearer $GARMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://shop.example/products/oxford-shirt-4.jpg",
    "background": "light grey studio"
  }'
Finished job · GET /jobs/{id}
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "ghost-mannequin",
  "status": "completed",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "succeeded",
      "label": "light grey studio",
      "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

backgroundThe background in a few words (up to 200 characters); a clean light studio background when empty.
Full reference

Cost

1 credit

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

API pricing

What people build with it

Apparel catalogs

The standard e-commerce look for every top, dress and jacket.

Marketplace listings

The garment alone, where a marketplace asks for no person in the photo.

Skip the second shoot

No mannequin, no compositing of front and back shots.

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

Does it keep the details?

It is told to reproduce the garment exactly: color, fabric, texture, print, logo, buttons, zips and stitching, without adding or removing any detail. Always check the result before it goes live.

What background do I get?

A clean, light studio background, or the one you describe in background, like "pure white".

What does it cost?

One credit per photo.

Other edits in the API

Get an API key

Test keys are free and need no pack.