Virtual TryOn API Documentation

Generate a virtual try-on from two images: a garment and a person (model) photo. One request in, one image out. Send as multipart/form-data or JSON.

curl -X POST https://www.tryoncloud.com/api/v1/generate \
  -H "X-API-KEY: tk_dev_v1_your_key_here" \
  -F "garment_image=@garment.jpg" \
  -F "person_image=@model.jpg" \
  --output result.png

// Node 18+ (native fetch & FormData). Call from your server, not the browser.
import fs from "node:fs";

const form = new FormData();
form.append("garment_image", new Blob([fs.readFileSync("garment.jpg")]), "garment.jpg");
form.append("person_image",  new Blob([fs.readFileSync("model.jpg")]),   "model.jpg");

const res = await fetch("https://www.tryoncloud.com/api/v1/generate", {
  method: "POST",
  headers: { "X-API-KEY": "tk_dev_v1_your_key_here" },
  body: form,
});

if (!res.ok) {
  const { error, code } = await res.json();
  throw new Error(`${code}: ${error}`);
}
// The response body IS the PNG — write the bytes to a file.
fs.writeFileSync("result.png", Buffer.from(await res.arrayBuffer()));

import requests

res = requests.post(
    "https://www.tryoncloud.com/api/v1/generate",
    headers={"X-API-KEY": "tk_dev_v1_your_key_here"},
    files={
        "garment_image": open("garment.jpg", "rb"),
        "person_image":  open("model.jpg", "rb"),
    },
    timeout=120,
)

if res.status_code != 200:
    print(res.json())            # {"error": "...", "code": "..."}
    raise SystemExit(1)

with open("result.png", "wb") as f:
    f.write(res.content)          # the response body is the PNG

<?php
$ch = curl_init("https://www.tryoncloud.com/api/v1/generate");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["X-API-KEY: tk_dev_v1_your_key_here"],
  CURLOPT_POSTFIELDS => [
    "garment_image" => new CURLFile("garment.jpg"),
    "person_image"  => new CURLFile("model.jpg"),
  ],
  CURLOPT_TIMEOUT => 120,
]);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 200) {
  file_put_contents("result.png", $body);   // the body IS the PNG
} else {
  echo $body;                                // {"error":"...","code":"..."}
}