> Garmo API docs as Markdown. This page: https://garmo.studio/api/docs/pose/ · All docs in one file: https://garmo.studio/api/docs/llms-full.txt

# Change pose

POST/edit/pose

Makes new photos of the same model in the same outfit and place, in other poses: back view, side, walking, seated and more.

Cost: 1 credit per pose. Images: Send exactly one photo: image_url, image_base64 or upload_id (or a multipart file named image). It makes one image per pose (plus one for a description or pose photo), at most 12 per request. Give at least one of poses, description or pose_image_url.

Overview and examples: Pose changer API.

## Parameters

- Parameter | Description
- poses  array | Pose ids from GET /catalog/poses. One of:  standing ,  three ,  side ,  back ,  walking ,  seated ,  pockets ,  leaning
- framing  string | How much of the model is in frame. Default  "full" . One of:  full ,  knee ,  waist
- description  string | A pose of your own in words (up to 200 characters).
- pose_image_url  string | A photo of someone in the pose you want; only the pose is copied (or pose_image_base64, pose_image_upload_id).
- back_image_urls  array | Up to 2 photos of the real back of the garment, so a back view is true to it.
- image_url  string | Public https URL of the photo to edit. JPEG, PNG or WebP, up to 12 MB. Private and local addresses are refused.
- image_base64  string | The photo itself, base64-encoded (a data: URI is fine). For large files use upload_id instead.
- upload_id  string | An id from POST /uploads.
- webhook_url  string | https address Garmo POSTs the finished job to (signed, see Webhooks).
- metadata  object | Your own JSON object (up to 1,000 characters), returned with the job and in the webhook.
Header Idempotency-Key (optional): see Retries and idempotency.

## Example

```
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"
  }'
```

```
const r = await fetch("https://api.garmo.studio/v1/edit/pose", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GARMO_API_KEY}`,
    "Idempotency-Key": "order-123-pose",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"image_url": "https://shop.example/products/jacket-7-on-model.jpg", "poses": ["walking", "side"], "framing": "full"}),
});
const job = await r.json();
console.log(job.id, job.status);
```

```
import os, requests

r = requests.post(
    "https://api.garmo.studio/v1/edit/pose",
    headers={"Authorization": f"Bearer {os.environ['GARMO_API_KEY']}", "Idempotency-Key": "order-123-pose"},
    json={
        "image_url": "https://shop.example/products/jacket-7-on-model.jpg",
        "poses": ["walking", "side"],
        "framing": "full",
    },
)
job = r.json()
print(job["id"], job["status"])
```

```
 true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(["image_url" => "https://shop.example/products/jacket-7-on-model.jpg", "poses" => ["walking", "side"], "framing" => "full"]),
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GARMO_API_KEY"), "Idempotency-Key: order-123-pose", "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/pose")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("GARMO_API_KEY")}"
req["Idempotency-Key"] = "order-123-pose"
req["Content-Type"] = "application/json"
req.body =  res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(res.statusCode() + " " + res.body());
    }
}
```

### Response: 202 Accepted

```
{
  "id": "job_8Kq2xV7mPz4LtR9wNc3B",
  "object": "job",
  "tool": "pose",
  "status": "processing",
  "livemode": true,
  "outputs": [
    {
      "id": "out_1",
      "status": "processing",
      "label": "Walking"
    },
    {
      "id": "out_2",
      "status": "processing",
      "label": "Side"
    }
  ],
  "credits_charged": 2,
  "credits_refunded": 0,
  "metadata": {
    "sku": "DR-123"
  },
  "created_at": "2026-11-19T14:02:11Z",
  "completed_at": null
}
```

### The finished job

```
{
  "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"
}
```

## Errors

400 invalid_request names the parameter that is missing or wrong. Image problems are invalid_image, image_too_large or image_unreachable. 402 insufficient_credits says how many credits the request needs. All codes: Errors.
