Search docs

Search the TryOnCloud API docs

Plateformes

React et Next.js

Ajoutez la fonctionnalité d'essayage à une boutique en ligne React ou Next.js à l'aide d'une route serveur.

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

Ajoutez la fonctionnalité d'essayage à une boutique en ligne React ou Next.js. Le navigateur envoie la photo de l'acheteur vers votre route serveur, et celle-ci appelle TryOnCloud à l'aide de la clé API. La clé n'est jamais transmise au navigateur.

Browser
Your Next.js route

POST /api/try-on (photo + product image URL)

▶

POST /api/v1/generate (X-API-KEY)

◀

200 image/png

◀

200 image/png

◀

1. Ajoutez votre clé

.env.local:

bash
TRYONCLOUD_API_KEY=tk_dev_v1_your_key_here

2. Routeur de serveurs (App Router)

app/api/try-on/route.ts:

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" } })
}

Dans le routeur de pages, ajoutez la même logique dans pages/api/try-on.ts et désactivez l'analyseur de corps par défaut afin que le téléchargement de fichiers puisse s'effectuer correctement.

3. Composant d'essayage

tsx
"use client"
import { useState } from "react"

export function TryOnButton({ productImageUrl }: { productImageUrl: string }) {
  const [result, setResult] = useState<string | null>(null)
  const [busy, setBusy] = useState(false)
  const [error, setError] = useState<string | null>(null)

  async function onFile(file: File) {
    setBusy(true)
    setError(null)
    const form = new FormData()
    form.append("person", file)
    form.append("garmentUrl", productImageUrl)
    const res = await fetch("/api/try-on", { method: "POST", body: form })
    setBusy(false)
    if (!res.ok) return setError((await res.json()).error)
    setResult(URL.createObjectURL(await res.blob()))
  }

  return (
    <div>
      <input type="file" accept="image/*" onChange={(e) => e.target.files?.[0] && onFile(e.target.files[0])} />
      {busy && <p>Creating your look, about 20 seconds...</p>}
      {error && <p role="alert">{error}</p>}
      {result && <img src={result} alt="You wearing this product" />}
    </div>
  )
}

Conseils

  • productImageUrl doit être une URL publique de type https (votre CDN ou le CDN de Shopify).
  • Afficher un message indiquant la progression : un essai dure environ 20 secondes.
  • Utilisez ?mock=true dans l'URL de l'API pendant la phase de développement ; c'est gratuit.
  • « Plain React » (Vite, CRA) fonctionne de la même manière ; la route serveur se trouve toutefois dans votre backend. Voir Node.js.