Pose changer API

AI pose changer API

Turn one on-model photo into a full set: the same person, outfit, place and light in a back view, a side view, walking or seated. Send the real back of the garment and the back view follows it.

Test keys are free and need no pack.

  • 8 ready poses, a pose in words, or a photo of the pose to copy.
  • Full body, knee up or waist up.
  • Up to 2 photos of the garment's real back for true back views.
Male model standing in a rust chore jacket and dark green trousers
Input
The same model walking towards the camera
walking
The same model in side profile
side
POST https://api.garmo.studio/v1/edit/pose
{
  "poses": [
    "walking",
    "side"
  ],
  "framing": "full"
}

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/pose \
  -H "Authorization: Bearer $GARMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://shop.example/products/jacket-7-on-model.jpg",
    "poses": [
      "walking",
      "side"
    ],
    "framing": "full"
  }'
Finished job · GET /jobs/{id}
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "pose",
  "status": "completed",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "succeeded",
      "label": "Walking",
      "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": "Side",
      "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

posesPose ids from GET /catalog/poses.
framingHow much of the model is in frame.
descriptionA pose of your own in words (up to 200 characters).
pose_image_urlA photo of someone in the pose you want; only the pose is copied (or pose_image_base64, pose_image_upload_id).
back_image_urlsUp to 2 photos of the real back of the garment, so a back view is true to it.
Full reference

Cost

1 credit per pose

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

API pricing

What people build with it

A full product gallery

Front, side, back and a walking shot for every product page from one photo.

Fit and drape

A walking shot shows how a dress moves; a side view shows a coat's length.

Consistent catalogs

The same set of poses for every product, made the same way.

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 the model's face stay the same?

Yes. The face, hair, skin tone and body come from your photo, and every garment is reproduced: color, fabric, print, logo and buttons.

How does it know the back of the garment?

It can only guess from the front. Send up to two photos of the real back in back_image_urls and the back view copies them.

What does it cost?

One credit per pose: four poses make four images.

Other edits in the API

Get an API key

Test keys are free and need no pack.