Plataformas
React e Next.js
Adicionar a funcionalidade de experimentar a uma loja virtual em React ou Next.js através de uma rota do servidor.
Os exemplos de código, os pontos de extremidade e os códigos de erro são os mesmos em todas as línguas.
Adicione a funcionalidade de experimentação a uma loja online em React ou Next.js. O navegador envia a fotografia do cliente para a rota do seu servidor, e essa rota chama o TryOnCloud utilizando a chave da API. A chave nunca chega ao navegador.
POST /api/try-on (photo + product image URL)
POST /api/v1/generate (X-API-KEY)
200 image/png
200 image/png
1. Adicione a sua chave
.env.local:
TRYONCLOUD_API_KEY=tk_dev_v1_your_key_here2. Rota do servidor (App Router)
app/api/try-on/route.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" } })
}No Pages Router, insira a mesma lógica no ficheiro pages/api/try-on.ts e desative o analisador de corpo padrão para que o envio do ficheiro seja permitido.
3. Componente de experimentação
"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>
)
}Dicas
productImageUrldeve ser um URL públicohttps(da sua CDN ou da CDN da Shopify).- Mostrar uma mensagem de progresso: uma experiência demora cerca de 20 segundos.
- Utilize
?mock=truena URL da API enquanto faz a compilação; é gratuito. - O Plain React (Vite, CRA) funciona da mesma forma; a rota do servidor fica no seu backend. Consulte Node.js.