Search docs

Search the TryOnCloud API docs

Commencer

Exemples complets

Intégrations complètes, prêtes à l'emploi (copier-coller), pour Node.js, Next.js, Python et PHP.

Les exemples de code, les points de terminaison et les codes d'erreur sont identiques dans tous les langages.

Des intégrations complètes que vous pouvez copier. Chacune d'entre elles conserve la clé API sur le serveur, gère les erreurs et renvoie l'image d'essayage à votre interface utilisateur.

Gestionnaire de routes Next.js

app/api/try-on/route.ts : votre interface utilisateur envoie ici la photo du client et l'URL de l'image du produit, puis reçoit le fichier PNG en retour.

ts
export const runtime = "nodejs"
export const maxDuration = 120

export async function POST(req: Request) {
  const incoming = await req.formData()
  const person = incoming.get("person")
  const garmentUrl = incoming.get("garmentUrl")
  if (!(person instanceof Blob) || typeof garmentUrl !== "string") {
    return Response.json({ error: "person file and garmentUrl are required" }, { status: 400 })
  }

  const form = new FormData()
  form.append("person_image", person, "person.jpg")
  form.append("garment_url", garmentUrl)

  const res = await fetch("https://www.tryoncloud.com/api/v1/generate", {
    method: "POST",
    headers: { "X-API-KEY": process.env.TRYONCLOUD_API_KEY! },
    body: form,
    signal: AbortSignal.timeout(120_000),
  })
  if (!res.ok) {
    const { error, code } = await res.json()
    return Response.json({ error, code }, { status: res.status })
  }
  return new Response(await res.arrayBuffer(), { headers: { "Content-Type": "image/png" } })
}

Node.js (Express)

js
import express from "express"
import multer from "multer"

const app = express()
const upload = multer({ limits: { fileSize: 15 * 1024 * 1024 } })

app.post("/try-on", upload.single("person"), async (req, res) => {
  const form = new FormData()
  form.append("person_image", new Blob([req.file.buffer]), "person.jpg")
  form.append("garment_url", req.body.garmentUrl)

  const r = await fetch("https://www.tryoncloud.com/api/v1/generate", {
    method: "POST",
    headers: { "X-API-KEY": process.env.TRYONCLOUD_API_KEY },
    body: form,
    signal: AbortSignal.timeout(120_000),
  })
  if (!r.ok) return res.status(r.status).json(await r.json())
  res.type("png").send(Buffer.from(await r.arrayBuffer()))
})

app.listen(3000)

Python

python
import os
import requests

def try_on(person_path: str, garment_path: str, out_path: str = "result.png") -> str:
    with open(person_path, "rb") as person, open(garment_path, "rb") as garment:
        r = requests.post(
            "https://www.tryoncloud.com/api/v1/generate",
            headers={"X-API-KEY": os.environ["TRYONCLOUD_API_KEY"]},
            files={"person_image": person, "garment_image": garment},
            timeout=120,
        )
    if r.status_code != 200:
        err = r.json()
        raise RuntimeError(f"{err['code']}: {err['error']}")
    with open(out_path, "wb") as f:
        f.write(r.content)
    return out_path

print(try_on("person.jpg", "shirt.jpg"))

PHP

php
<?php
$ch = curl_init("https://www.tryoncloud.com/api/v1/generate");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120,
    CURLOPT_HTTPHEADER => ["X-API-KEY: " . getenv("TRYONCLOUD_API_KEY")],
    CURLOPT_POSTFIELDS => [
        "person_image" => new CURLFile("person.jpg"),
        "garment_url"  => "https://cdn.yourstore.com/shirt.jpg",
    ],
]);
$body   = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status !== 200) {
    $err = json_decode($body, true);
    throw new Exception($err["code"] . ": " . $err["error"]);
}
file_put_contents("result.png", $body);

Partie avant

Le navigateur communique uniquement avec votre serveur, jamais directement avec TryOnCloud :

js
const form = new FormData()
form.append("person", fileInput.files[0])
form.append("garmentUrl", product.imageUrl)

const res = await fetch("/api/try-on", { method: "POST", body: form })
if (res.ok) resultImg.src = URL.createObjectURL(await res.blob())