Generation Tools

Virtual Try-On (Single)

Put one garment photo on an AI fashion model — pick the model, pose and venue, or let Fashio choose a clean studio default.

toolId: "virtual_model" 4 credits model_garment ratio: global (default 1:1)

Virtual try-on result — garment on an AI fashion model

What it does

One garment photo goes on one AI fashion model. The garment's cut, print, hardware and any logo are reproduced exactly — the model, pose and background are what change.

Request body

Field	Type		Description
`toolId`	string	required	Always `"virtual_model"`.
`images.fashion_model`	string	required	A catalog ID from GET /v1/fashion-models, or a direct image URL.
`images.garment_photo`	string	required	URL of the garment photo (from `POST /v1/uploads` or your own hosting).
`images.venue`	string	optional	A catalog ID from GET /v1/venues, or a direct image URL. Omit for a clean studio background.
`pose`	string	optional	A catalog ID from GET /v1/poses. Omit for a natural standing pose.
`ratio`	string	optional	One of `1:1`, `4:5`, `3:4`, `9:16`, `16:9`. Defaults to `1:1`.

Example request

curl -X POST https://api.fashiolabs.com/v1/generations \
  -H "Authorization: Bearer fio_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toolId": "virtual_model",
    "images": {
      "fashion_model": "fm_south_asian_01",
      "garment_photo": "https://your-cdn.com/dress.jpg",
      "venue": "venue_studio_white"
    },
    "pose": "pose_standing_relaxed",
    "ratio": "4:5"
  }'

const res = await fetch("https://api.fashiolabs.com/v1/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.FASHIO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    toolId: "virtual_model",
    images: {
      fashion_model: "fm_south_asian_01",
      garment_photo: "https://your-cdn.com/dress.jpg",
      venue: "venue_studio_white",
    },
    pose: "pose_standing_relaxed",
    ratio: "4:5",
  }),
});
const { id } = await res.json();

import os, requests

res = requests.post(
    "https://api.fashiolabs.com/v1/generations",
    headers={"Authorization": f"Bearer {os.environ['FASHIO_API_KEY']}"},
    json={
        "toolId": "virtual_model",
        "images": {
            "fashion_model": "fm_south_asian_01",
            "garment_photo": "https://your-cdn.com/dress.jpg",
            "venue": "venue_studio_white",
        },
        "pose": "pose_standing_relaxed",
        "ratio": "4:5",
    },
)
job_id = res.json()["id"]

Response

202 Accepted{ "success": true, "id": "8b1e...", "status": "processing" }

Poll GET /v1/generations/:id (see Quickstart) until it completes:

200 · completed{
  "success": true,
  "id": "8b1e...",
  "status": "completed",
  "resultUrls": ["https://.../result.jpg"],
  "errorMessage": null
}

Common errors

Status	Meaning
400	`virtual_model: missing required image "fashion_model"` — required image field wasn't resolvable.
402	`Insufficient diamonds. Required 4, have <n>.`
429	Daily request cap reached for this key — see Rate Limits.

Virtual Try-On (Batch) — same idea, multiple garments in one shot.
Pro Studio — adds shot-type and style-preset controls.
Model Swap — change who's wearing an existing photo instead.