Swap Handles

Replace or remove cabinet handles and knobs on a real kitchen photo.

Module id: swap-handles · Asynchronous job

Endpoint

POST https://kitchengpt.io/v1/modules/swap-handles

Request parameters

Name	Type	Required	Description
image	file	yes	Kitchen photo, max 10 MB.
action	string	yes	One of: replace, remove.
hardware_image	file	no	Reference photo of the new handle (required when action=replace).

Example

curl -X POST "https://kitchengpt.io/v1/modules/swap-handles" \
  -H "Authorization: Bearer kgpt_..." \
  -H "Accept: application/json" \
  -F "image=@file.jpg" \
  -F "action=value" \
  -F "hardware_image=@file.jpg"

Response

HTTP/1.1 202 Accepted
{
  "job": {
    "id": "…",
    "module": "swap-handles",
    "status": "queued"
  },
  "links": {
    "self": "https://kitchengpt.io/v1/jobs/…"
  }
}

Poll GET https://kitchengpt.io/v1/jobs/{id} until succeeded or failed.

Notes

Images must be JPEG, PNG, or WebP, max 10 MB.
Inputs must depict a kitchen. Other room types are not supported.
Do not rely on pixel-perfect color matching for manufacturing without your own QA.