F Fashio Docs
Generation Tools

Pro Studio

Virtual try-on with explicit shot-type and style-preset controls — for brands that want a specific framing or aesthetic rather than a default studio look.

toolId: "pro_studio" 4 credits model_garment ratio: global (default 1:1)
Pro Studio result — fashion model shot with a specific shot type and style preset

What it does

Adds explicit shot-type and style-preset controls on top of the standard try-on — for brands that want a specific framing or aesthetic rather than a default studio look.

Request body

FieldTypeDescription
toolIdstringrequiredAlways "pro_studio".
images.fashion_modelstringrequiredA catalog ID from GET /v1/fashion-models, or a direct image URL.
images.garment_photosstring[]requiredArray of garment photo URLs — at least one.
shotTypestringoptionalOne of full_body, half_body, close_up. Omit for full body.
stylePresetstringoptionalOne of modern_ecom, white_seamless, hard_flash, outdoor_lifestyle. Omit for modern_ecom.
ratiostringoptionalOne 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": "pro_studio",
    "images": {
      "fashion_model": "fm_south_asian_01",
      "garment_photos": ["https://your-cdn.com/dress.jpg"]
    },
    "shotType": "half_body",
    "stylePreset": "white_seamless",
    "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: "pro_studio",
    images: {
      fashion_model: "fm_south_asian_01",
      garment_photos: ["https://your-cdn.com/dress.jpg"],
    },
    shotType: "half_body",
    stylePreset: "white_seamless",
    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": "pro_studio",
        "images": {
            "fashion_model": "fm_south_asian_01",
            "garment_photos": ["https://your-cdn.com/dress.jpg"],
        },
        "shotType": "half_body",
        "stylePreset": "white_seamless",
        "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

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