Guide · Virtuell try-on

Vad är ett API för virtuell try-on? och vad det returnerar

I en mening

Ett API för virtuell try-on tar emot ett plaggfoto och returnerar en bild av plagget buret av en modell. Du gör en POST med fotot tillsammans med en docka och en pose, pollar jobbet och laddar sedan ned resultatet.

Hämta en API-nyckelLäs dokumentationen
  • Typisk tid: 1.5–4 min
  • Credits: 5 credits vid 2K · 6 credits vid 4K
  • Bearbetning: asynkron, polling

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Det korta svaret

Ett API för virtuell try-on är en HTTP-endpoint som renderar ett plagg på en modell. Du skickar ett fotografi av produkten — vanligtvis den flat-lay- eller dockbild du redan har — och tjänsten returnerar en bild där plagget bärs. Ingen studio, ingen modellbokning, ingen ny fotografering när färgställningen ändras.

Anropet är asynkront eftersom renderingen tar längre tid än vad en förfrågan bör vänta. Du gör en POST med plagget tillsammans med önskad modell och pose, API:et accepterar jobbet och returnerar ett id, och du pollar en status-endpoint tills jobbet rapporterar att det är klart. Den färdiga bilden levereras som en URL som du själv laddar ner och lagrar.

De vanligaste användarna är katalogteam som behöver modellbilder för produkter som aldrig når en studio, marknadsplatser som tar emot flat-lay-foton från säljare, samt appar som låter kunden se ett plagg på en annan kroppstyp än varumärkets enda provmodell.

Endpointen som gör det

Hämtat från Phottas API-dokumentation, inte skrivet för hand.

I korthet

Endpoint
POST /api/v1/tryon/apparel
Autentisering
Bearer API-nyckel
Bearbetning
Asynkron — polla status-endpointen
Typisk tid
1.5–4 min
Credits
5 credits vid 2K · 6 credits vid 4K
Bildförhållanden
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Indatagränser
Upp till 10 MB per bild; JPEG, PNG, WebP
Idempotent
Nej

Vad du ska leta efter i ett try-on-API

  • Vad du skickar

    Ett fotografi av plagget som en https-URL eller en base64-data-URI, plus den modell och pose du vill ha. Photta accepterar JPEG, PNG och WebP upp till 10 MB per bild.

  • Hur lång tid det tar

    Tillräckligt länge för att det inte ska kunna göras i ett vanligt webbanrop. Photta publicerar en typisk svarstid per endpoint och förväntar sig pollning var 3:e sekund — det finns inga webhooks.

  • Vad det kostar

    Photta debiterar credits per anrop, 5 vid 2K och 6 vid 4K för try-on av kläder, som dras när jobbet startar och återbetalas automatiskt om det misslyckas.

  • Vilka gränser som gäller

    En publicerad rate limit på 600 anrop per minut per nyckel, samt ett tak per prisplan för hur mycket som kan renderas samtidigt. Båda är värda att läsa igenom innan en körning i katalogstorlek.

Den första requesten

Samma anrop i cURL, Node.js och 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')

Frågor om API:er för virtuell try-on

Vad returnerar ett try-on-API?

En bild av plagget buret av modellen du valde, levererad som en URL i det slutförda jobbet. Ladda ner och lagra den — en leverans-URL är inte en permanent hosting.

Behöver jag ett foto på en modell?

Nej. Photta tillhandahåller en dockkatalog som du kan välja från, och du kan generera en egen modell utifrån attribut eller ladda upp en. Fotografiet av plagget är den enda bilden du måste tillhandahålla.

Hur skiljer sig detta från ett virtuellt provrum?

Ett provrum är en funktion riktad mot slutkunden. Ett try-on-API är renderingssteget under huven: ett anrop in, en bild ut. Du kan bygga ett provrum ovanpå det, eller använda det enbart för att producera katalogbilder.

Vad kostar ett try-on-anrop?

Med Photta, 5 credits vid 2K och 6 vid 4K. Misslyckade jobb återbetalas, så kostnaden för ett nytt försök är bara själva återförsöket.

Hur lång tid tar en bild?

Endpointen publicerar sin typiska handläggningstid, och jobbet rapporterar sin egen status. Polla var 3:e sekund i stället för att anta en viss tidsåtgång.

Läs vidare

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Testa med ditt eget produktfoto

Ett anrop, en pollning, en bild.

Skapa ett konto och hämta en API-nyckelSe endpoint
  • 1.5–4 min
  • 5 credits vid 2K · 6 credits vid 4K
  • asynkron, polling