---
title: "Multi-pose try-on variations"
method: POST
path: "/v1/try-on/variations"
tags: ["Virtual Try-On"]
---

# Multi-pose try-on variations

`POST /v1/try-on/variations`

## Request

- Base URL: `https://api.crayonz.ai`
- URL: `https://api.crayonz.ai/v1/try-on/variations`
- Auth: API key in header `X-API-Key`

Generate multiple pose variations from a single user + product pair.

## Request body

- object
  - `userPhoto` string, required
  - `productImage` string, required
  - `posePresets` object[]: 1–4 custom poses, each { id, pose } where pose is a short text description

## Response `200`

Success

- object
  - `taskId` string: Poll GET /v1/tasks/{taskId} — resultImages carries one entry per pose
  - `status` string: queued, processing, completed or failed
  - `message` string

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `402`: Insufficient credits
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/crayonz/apis/crayonz-api.md) · [All operations](https://skmtc.dev/crayonz/apis/crayonz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crayonz/apis/crayonz-api/revisions/1114c84167b2?raw)