Opas · Virtual try-on

Mikä on virtual try-on -API? ja mitä se palauttaa

Yhdellä lauseella

Virtual try-on -API ottaa vastaan vaatevalokuvan ja palauttaa kuvan kyseisestä vaatteesta mallin yllä. Teet POST-pyynnön kuvasta mallinuken ja asennon kera, teet pollingia työlle ja lataat sitten tuloksen.

Hanki API-avainLue dokumentaatio
  • Tyypillinen kesto: 1.5–4 min
  • Credits: 5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K
  • Käsittely: asynkroninen, polling

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

Lyhyt vastaus

Virtuaalinen try-on-API on HTTP-endpoint, joka renderöi vaatteen mallin päälle. Lähetät tuotekuvan — yleensä valmiina olevan tasokuvan tai mallinukkekuvan — ja palvelu palauttaa kuvan vaatteesta mallin yllä. Ei studiota, ei mallivarauksia, ei uudelleenkuvauksia värivaihtoehdon muuttuessa.

Kutsu on asynkroninen, koska renderöinti kestää kauemmin kuin yksittäisen pyynnön kannattaa odottaa. Teet POST-pyynnön vaatteesta haluamallasi mallilla ja asennolla, API hyväksyy työn ja palauttaa id-tunnisteen, ja teet polling-kyselyitä status-endpointiin, kunnes työ ilmoittaa tilakseen completed. Valmis kuva toimitetaan URL-osoitteena, jonka lataat ja tallennat itse.

Tyypillisiä käyttäjiä ovat katalogitiimit, jotka tarvitsevat mallikuvia tuotteista, jotka eivät koskaan päädy studioon, markkinapaikat, jotka vastaanottavat myyjiltä tasokuvia, sekä sovellukset, joissa ostaja voi nähdä vaatteen muunlaisen kuin brändin ainoan sovitusmallin vartalolla.

Endpoint, joka tekee sen

Luettu Photta-API-dokumentaatiosta, ei käsin kirjoitettu.

Lyhyesti

Endpoint
POST /api/v1/tryon/apparel
Autentikointi
Bearer-API-avain
Käsittely
Asynkroninen — tee polling-kyselyitä status-endpointiin
Tyypillinen kesto
1.5–4 min
Credits
5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K
Kuvasuhteet
3:4 · 1:1 · 4:3 · 9:16 · 16:9
Syöterajoitukset
Enintään 10 MB per kuva; JPEG, PNG, WebP
Idempotentti
Ei

Mitä etsiä mistä tahansa try-on-API:sta

  • Mitä lähetät

    Vaatekuvan https-URL-osoitteena tai base64 data URI -muodossa sekä haluamasi mallin ja asennon. Photta tukee JPEG-, PNG- ja WebP-muotoja 10 MB kokoon asti per kuva.

  • Kauan se kestää

    Sen verran kauan, ettei sitä voi tehdä yhden web-pyynnön sisällä. Photta ilmoittaa tyypillisen valmistumisajan per endpoint ja edellyttää polling-kyselyä 3 sekunnin välein — webhooks-tukea ei ole.

  • Mitä se maksaa

    Photta veloittaa credits-yksiköitä per kutsu, vaatteiden try-on-toiminnossa 5 resoluutiolla 2K ja 6 resoluutiolla 4K. Ne veloitetaan työn alkaessa ja palautetaan automaattisesti, jos työ epäonnistuu.

  • Mitä rajoituksia sovelletaan

    Julkaistu rate limit on 600 pyyntöä minuutissa per avain, minkä lisäksi käytössä on tilauskohtainen raja samanaikaisesti renderöitävälle määrälle. Molempiin kannattaa tutustua ennen koko katalogin laajuista ajoa.

Ensimmäinen pyyntö

Sama kutsu cURL-, Node.js- ja Python-kielillä.

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')

Kysymyksiä virtual try-on -API:eista

Mitä try-on-API palauttaa?

Kuvan vaatteesta valitsemasi mallin yllä, toimitettuna URL-osoitteena valmistuneessa työssä. Lataa ja tallenna se — toimitus-URL ei ole pysyvä tiedostohostaus.

Tarvitsenko kuvan mallista?

Et. Phottan mukana tulee mallinukkekatalogi, josta voit valita, ja voit luoda oman mallin attribuuttien pohjalta tai ladata sellaisen. Vaatekuva on ainoa kuva, joka sinun on toimitettava.

Miten tämä eroaa virtuaalisesta sovituskopista?

Sovituskoppi on loppuasiakkaalle näkyvä ominaisuus. Try-on-API on sen taustalla toimiva renderöintivaihe: yksi kutsu sisään, yksi kuva ulos. Voit rakentaa sovituskopin sen päälle tai käyttää sitä puhtaasti katalogikuvien tuottamiseen.

Mitä try-on-kutsu maksaa?

Phottalla 5 credits resoluutiolla 2K ja 6 resoluutiolla 4K. Epäonnistuneet työt hyvitetään, joten uudelleenyrityksen hinta on vain itse uudelleenyritys.

Kauan yhden kuvan tekeminen kestää?

Endpoint ilmoittaa tyypillisen valmistumisaikansa, ja työ raportoi oman tilansa. Tee polling-kysely 3 sekunnin välein keston olettamisen sijaan.

Lue seuraavaksi

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

Kokeile sitä omaan tuotekuvaasi

Yksi pyyntö, yksi polling-kysely, yksi kuva.

Luo tili ja hanki API-avainKatso endpoint
  • 1.5–4 min
  • 5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K
  • asynkroninen, polling