Guide · Virtuell try-on

Hva er et API for virtuell try-on? og hva det returnerer

I én setning

Et API for virtuell try-on tar et bilde av et plagg og returnerer et bilde av dette plagget båret av en modell. Du sender en POST med bildet sammen med en mannequin og en positur, poller jobben, og laster deretter ned resultatet.

Få en API-nøkkelLes dokumentasjonen
  • Typisk tidsbruk: 1.5–4 min
  • Credits: 5 credits ved 2K · 6 credits ved 4K
  • Prosessering: asynkron, polling

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

Det korte svaret

Et API for virtuell try-on er et HTTP-endepunkt som renderer et plagg på en modell. Du sender et fotografi av produktet — vanligvis et flat lay- eller ginebilde du allerede har — og tjenesten returnerer et bilde av plagget i bruk. Uten studio, uten modellbooking og uten ny fotografering når fargevarianten endres.

Kallet er asynkront fordi renderingen tar lenger tid enn en forespørsel bør vente. Du sender plagget med en POST-forespørsel sammen med modellen og posituren du ønsker, API-et godtar jobben og returnerer en id, og du poller et statusendepunkt til jobben rapporterer at den er fullført. Det ferdige bildet leveres som en URL du selv laster ned og lagrer.

De vanlige klientene er katalogteam som trenger modellbilder for produkter som aldri når et studio, markedsplasser som mottar flate fotografier fra selgere, og apper som lar en kunde se et plagg på en annen kropp enn merkevarens ene faste modell.

Endepunktet som gjør det

Hentet direkte fra Photta API-dokumentasjonen, ikke skrevet for hånd.

Kort oppsummert

Endepunkt
POST /api/v1/tryon/apparel
Autentisering
Bearer API-nøkkel
Prosessering
Asynkron – poll status-endepunktet
Typisk tidsbruk
1.5–4 min
Credits
5 credits ved 2K · 6 credits ved 4K
Bildeformater
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Inndatagrenser
Opptil 10 MB per bilde; JPEG, PNG, WebP
Idempotent
Nei

Hva du bør se etter i ethvert try-on-API

  • Hva du sender

    Et fotografi av plagget som en https-URL eller en base64 data-URI, pluss modellen og posituren du ønsker. Photta støtter JPEG, PNG og WebP opptil 10 MB per bilde.

  • Hvor lang tid det tar

    Lenge nok til at det ikke kan gjøres i én enkelt webforespørsel. Photta oppgir typisk fullføringstid per endepunkt og forventer polling hvert 3. sekund — det finnes ingen webhooks.

  • Hva det koster

    Photta trekker credits per kall, 5 ved 2K og 6 ved 4K for try-on av klær, som belastes når jobben starter og refunderes automatisk hvis den feiler.

  • Hvilke begrensninger som gjelder

    En publisert rate limit på 600 forespørsler per minutt per nøkkel, og en grense per plan for hvor mye som kan renderes samtidig. Begge er verdt å lese før en kjøring i katalogstørrelse.

Den første forespørselen

Det samme kallet i cURL, Node.js og Python.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

Spørsmål om API-er for virtuell try-on

Hva returnerer et try-on-API?

Et bilde av plagget båret av modellen du valgte, levert som en URL i den fullførte jobben. Last det ned og lagre det — en leverings-URL er ikke permanent hosting.

Trenger jeg et bilde av en modell?

Nei. Photta leveres med en ginekatalog du kan velge fra, og du kan generere din egen modell ut fra attributter eller laste opp en. Fotografiet av plagget er det eneste bildet du må oppgi.

Hvordan skiller dette seg fra et virtuelt prøverom?

Et prøverom er en funksjon rettet mot sluttbrukeren. Et try-on-API er renderingssteget under: ett kall inn, ett bilde ut. Du kan bygge et prøverom på toppen, eller bruke det utelukkende til å produsere katalogbilder.

Hva koster et try-on-kall?

Hos Photta, 5 credits ved 2K og 6 ved 4K. Feilede jobber refunderes, så kostnaden for et nytt forsøk er selve forsøket.

Hvor lang tid tar ett bilde?

Endepunktet oppgir typisk fullføringstid, og jobben rapporterer sin egen status. Poll hvert 3. sekund i stedet for å anta en varighet.

Les videre

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

Prøv det på ditt eget produktbilde

Én forespørsel, én polling, ett bilde.

Opprett en konto og få en API-nøkkelSe endepunktet
  • 1.5–4 min
  • 5 credits ved 2K · 6 credits ved 4K
  • asynkron, polling