Gids · Virtual try-on

Wat is een virtual try-on-API? en wat deze retourneert

In één zin

Een virtual try-on-API neemt een kledingfoto en retourneert een afbeelding van dat kledingstuk gedragen door een model. Je POST de foto met een mannequin en een pose, pollt de taak en downloadt het resultaat.

API-sleutel ophalenLees de documentatie
  • Typische duur: 1.5–4 min
  • Credits: 5 credits bij 2K · 6 credits bij 4K
  • Verwerking: async, polling

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd

Het korte antwoord

Een virtual try-on API is een HTTP-endpoint dat een kledingstuk op een model rendert. Je stuurt een foto van het product — meestal de flat lay of paspopfoto die je al hebt — en de service retourneert een afbeelding waarop dat kledingstuk gedragen wordt. Geen studio, geen modellen boeken, geen reshoot wanneer de kleurstelling verandert.

De call is asynchroon omdat renderen langer duurt dan een request zou moeten wachten. Je stuurt via POST het kledingstuk in met het gewenste model en de pose, de API accepteert de taak en geeft een id terug, en je pollt een status endpoint totdat de taak meldt dat deze voltooid is. De uiteindelijke afbeelding wordt geleverd als een URL die je zelf downloadt en opslaat.

De gebruikelijke aanroepers zijn catalogusteams die on-model beeldmateriaal nodig hebben voor producten die nooit een studio halen, marktplaatsen die platte foto's van verkopers ontvangen, en apps waarmee een shopper een kledingstuk op een ander lichaam kan zien dan het vaste pasmodel van het merk.

Het endpoint dat dit doet

Overgenomen uit de Photta API-documentatie, niet handmatig geschreven.

In één oogopslag

Endpoint
POST /api/v1/tryon/apparel
Authenticatie
Bearer API key
Verwerking
Asynchroon — poll het status-endpoint
Typische duur
1.5–4 min
Credits
5 credits bij 2K · 6 credits bij 4K
Beeldverhoudingen
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Invoerlimieten
Tot 10 MB per afbeelding; JPEG, PNG, WebP
Idempotent
Nee

Waarop te letten bij elke try-on-API

  • Wat je verstuurt

    Een kledingfoto als https-URL of base64-data-URI, plus het model en de pose die je wilt. Photta accepteert JPEG, PNG en WebP tot 10 MB per afbeelding.

  • Hoe lang het duurt

    Lang genoeg dat het niet binnen een webrequest kan worden afgehandeld. Photta publiceert een typische verwerkingstijd per endpoint en verwacht polling elke 3 seconden — er zijn geen webhooks.

  • Wat het kost

    Photta rekent credits per call, 5 bij 2K en 6 bij 4K voor apparel try-on, afgeschreven wanneer de taak start en automatisch terugbetaald wanneer deze mislukt.

  • Welke limieten gelden er

    Een gepubliceerde rate limit van 600 requests per minuut per sleutel, en een limiet per abonnement op hoeveel er tegelijk kan renderen. Het is de moeite waard om beide te controleren vóór een run op catalogusschaal.

De eerste request

Dezelfde aanroep in cURL, Node.js en 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')

Vragen over virtual try-on-API's

Wat retourneert een try-on API?

Een afbeelding van het kledingstuk gedragen door het gekozen model, geleverd als een URL in de voltooide taak. Download en sla deze zelf op — een delivery-URL is geen permanente hosting.

Heb ik een foto van een model nodig?

Nee. Photta levert een paspopcatalogus waaruit je kunt kiezen, en je kunt een eigen model genereren op basis van attributen of er een uploaden. De kledingfoto is de enige afbeelding die je verplicht moet aanleveren.

Hoe verschilt dit van een virtuele paskamer?

Een paskamer is een feature voor de shopper. Een try-on API is de renderstap eronder: één call erin, één afbeelding eruit. Je kunt er een paskamer bovenop bouwen, of het puur gebruiken om catalogusfotografie te produceren.

Wat kost een try-on call?

Bij Photta 5 credits bij 2K en 6 bij 4K. Mislukte taken worden terugbetaald, dus de kosten van een retry zijn enkel de retry zelf.

Hoe lang duurt één afbeelding?

Het endpoint publiceert zijn typische verwerkingstijd, en de taak rapporteert zijn eigen status. Poll elke 3 seconden in plaats van uit te gaan van een vaste duur.

Lees verder

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd

Probeer het op je eigen productfoto

Eén request, één poll, één afbeelding.

Maak een account aan en haal een API-sleutel opBekijk het endpoint
  • 1.5–4 min
  • 5 credits bij 2K · 6 credits bij 4K
  • async, polling