API Free WeekHundreds of APIs are free to call this week.Browse free APIs

try-on

sandbase-ai/cat-vton

Cat Vton by sandbase-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.

Base price
$0.0013USD / run
Execution
async
Model type
image
Input fields
7
Production route

Try the model

Playground

Open playground
Input
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
020
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. Range: 0 to 20.
150
The number of inference steps to perform. Range: 1 to 50.
The same seed and the same input given to the same version of the model will output the same image every time.
Type of the Cloth to be tried on. Options: upper: Upper body cloth lower: Lower body cloth overall: Full body cloth inner: Inner cloth, like T-shirt inside a jacket outer: Outer cloth, like a jacket over a T-shirt Allowed values: upper, lower, overall, inner, outer.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Url to the garment image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Url for the human image.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.0013 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
sandbase-ai
Model ID
sandbase-ai/cat-vton
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

try-on

CatVTON virtual try-on: dress the person in human_image_url with the garment in garment_image_url.

Fields

FieldTypeDefaultNotes
aspect_ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16—Output frame shape.
guidance_scalenumber 0–202.5How strictly to follow the garment.
num_inference_stepsinteger 1–5030More steps add detail and time.
seedintegerrandomFix it to compare prompt changes.
cloth_typeupper / lower / overall / inner / outer—Which body area the garment covers.
garment_image_urlimage URL—Photo of the garment.
human_image_urlimage URL—Photo of the person.

Billing

$0.00125 per image.

RequestPrice
One image$0.0013

Failed runs are not charged.

Prompting

  • Use a front-facing person photo and a flat garment photo.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
sandbase-ai/cat-vton
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "sandbase-ai/cat-vton",
  "cloth_type": "upper",
  "guidance_scale": 2.5,
  "human_image_url": "https://static.sandbase.ai/examples/bfl/flux-2/virtual-tryon/input_images_0.png",
  "garment_image_url": "https://static.sandbase.ai/examples/bfl/flux-2/virtual-tryon/input_images_1.png",
  "num_inference_steps": 30
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
try-onThis model
sandbase-ai
Image$0.00 / runDec 17, 2024

Questions

FAQ

How do I call sandbase-ai try-on through SandBase?

Create a SandBase API key, then send requests with the model ID "sandbase-ai/cat-vton" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate sandbase-ai account?

No. One SandBase API key and balance gives you access to sandbase-ai try-on and the other models in the catalog; you do not need to sign up with sandbase-ai separately.