Model swap API

AI model swap API for fashion photos

Show the same look on several people: send an on-model photo and the models you want, get the same outfit, pose, room and light on each of them. Use Garmo's models or the models you created in Garmo Studio.

Test keys are free and need no pack.

  • Garmo's models by id from GET /catalog/models.
  • Your own Studio models as custom_<id>.
  • Outfit, pose, framing, background and light stay.
Model in a black double-breasted blazer dress in a sunlit room
Input
The same blazer dress, pose and room with another model
amara
The same blazer dress, pose and room with a third model
emma
POST https://api.garmo.studio/v1/edit/model-swap
{
  "models": [
    "amara",
    "emma"
  ]
}

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/model-swap \
  -H "Authorization: Bearer $GARMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://shop.example/products/blazer-dress-9.jpg",
    "models": [
      "amara",
      "emma"
    ]
  }'
Finished job · GET /jobs/{id}
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "model-swap",
  "status": "completed",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "succeeded",
      "label": "Amara",
      "url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…0.webp?X-Amz-Signature=…",
      "url_expires_at": "2026-11-20T14:00:00Z"
    },
    {
      "id": "out_2",
      "status": "succeeded",
      "label": "Emma",
      "url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…1.webp?X-Amz-Signature=…",
      "url_expires_at": "2026-11-20T14:00:00Z"
    }
  ],
  "credits_charged": 2,
  "credits_refunded": 0,
  "metadata": {
    "sku": "DR-123"
  },
  "created_at": "2026-11-19T14:02:11Z",
  "completed_at": "2026-11-19T14:02:58Z"
}

Parameters

modelsModel ids from GET /catalog/models: Garmo models by name ("klara") or your own models in Garmo Studio ("custom_<id>").
Full reference

Cost

1 credit per model

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

API pricing

What people build with it

Show more people

The same piece on several models for a wider audience.

Market versions

A different model per market from one shoot.

One face per collection

The same Garmo model across every product of a collection.

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

Can I use my own model?

Yes. Models you create in Garmo Studio appear in GET /catalog/models as custom_<id> for your account.

Is it a virtual try-on?

No. It changes who wears the outfit in a photo you already have. To put a product on a model from a flat lay, use Garmo Studio's photoshoot.

What does it cost?

One credit per model.

Other edits in the API

Get an API key

Test keys are free and need no pack.