Vaatteet · Ominaisuus
Virtual Try-On API — Photta
Yksi REST-kutsu muuttaa vaatekuvan kampanjalaatuiseksi mallikuvaksi. Asynkroninen, 1.5–4 minuuttia per generointi, 5 krediittiä 2K-resoluutiolla tai 7 krediittiä 4K-resoluutiolla.
Yhdellä lauseella
Phottan virtuaalinen sovitus-API hyväksyy vaatekuvan, mallitunnuksen ja asentotunnuksen, ja palauttaa 2K- tai 4K-mallikuvan. Tunnistautuminen tapahtuu `Authorization: Bearer photta_live_xxx` -otsakkeella, lähetä POST osoitteeseen `/api/v1/tryon/apparel`, pollata päätepistettä palautetulla tunnuksella 3–5 sekunnin välein ja lataa tulos, kun tila on `completed`.
curl -X POST https://ai.photta.app/api/v1/tryon/apparel \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_type": "dress",
"product_images": ["https://example.com/dress.jpg"],
"mannequin_id": "mnq_athena_ts",
"pose_id": "pose_standing_front",
"resolution": "2K",
"aspect_ratio": "3:4"
}'Mitä odottaa
Typical completion
1.5–4min
2K / 4K credits
5 / 7
Aspect ratios
5
Product types
6
Koodi alusta loppuun
Valitse kieli
Sama päätepiste, kolme suoritettavaa ohjetta. Jokainen koodinpätkä vastaa virallista Photta-dokumentaatiota.
Miten se toimii
Neljä API-kutsua, yksi tuotekuva
Valitse malli ja asento, lähetä tehtävä, pollata valmistumiseen asti, lataa tulos.
- 01
Vaihe 1
Generoi API-avain
Rekisteröidy osoitteessa ai.photta.app, avaa Developers-välilehti ja klikkaa Generate API key. Live-avaimet alkavat tunnisteella `photta_live_`. Aseta avain muuttujaan `PHOTTA_API_KEY` — älä koskaan tallenna sitä koodiin.
- 02
Vaihe 2
Valitse malli ja asento
GET `/api/v1/mannequins` ja `/api/v1/poses` listaavat vaihtoehdot. Valitse brändillesi sopivat tunnukset — koko, ilme, etnisyys ja asento ovat kaikki suodatettavissa.
- 03
Vaihe 3
Lähetä sovitustehtävä
Lähetä POST osoitteeseen `/api/v1/tryon/apparel` sisältäen `product_type`, `product_images`, `mannequin_id`, `pose_id`, `resolution` ja `aspect_ratio`. API palauttaa 202 Accepted ja generointitunnuksen.
- 04
Vaihe 4
Pollata valmistumiseen asti
GET `/api/v1/tryon/apparel/:id` 3 sekunnin välein. Kun `data.status` on `completed`, vastaus sisältää `output_url` ja `thumbnail_url`. Aseta yläraja kokeiluille, jotta jumiutunut tehtävä ei jää roikkumaan.
- 05
Vaihe 5
Lataa ja tallenna
Hae tavut osoitteesta `output_url` ja tallenna ne omaan objektitallennustilaasi. CDN-osoite on vakaa, mutta tuotteesi ei pitäisi riippua siitä renderöinnissä.
Muiden kehittäjien kysymyksiä
Kysymyksiä kehittäjiltä ennen sovitus-API:n julkaisua
Mikä on Phottan virtuaalinen sovitus-API?+
REST-päätepiste, joka ottaa tuotekuvan sekä tunnusparin (malli + asento) ja palauttaa fotorealistisen mallikuvan. Sama putki kuin Phottan kuluttajasovelluksessa. Tuetut tuotetyypit: yläosa, alaosa, ylä+alaosa, mekko, yksiosainen, haalari.
Paljonko yksi kutsu maksaa?+
5 krediittiä 2K-tuloksesta, 7 krediittiä 4K-tuloksesta. Krediitit kuuluvat tilaukseesi ja niitä voi ostaa lisää. Epäonnistuneet generoinnit eivät maksa krediittejä — ne hyvitetään.
Kauanko generointi kestää?+
Tyypillinen valmistumisaika on 1.5–4 minuuttia alusta loppuun. POST-kutsu palauttaa tunnuksen alle sekunnissa; GPU-työ tapahtuu taustalla kyselyiden aikana.
Mitä tuotetyyppejä tuetaan?+
Kuusi: `top`, `bottom`, `top_and_bottom`, `dress`, `one_piece`, `jumpsuit`. Jokainen odottaa tiettyä `product_images`-muotoa — esimerkiksi `top_and_bottom` vaatii sekä `top_image`- että `bottom_image`-osoitteet.
Voinko käyttää omaa malliani?+
Kyllä. Lataa mallikuva osoitteeseen `/api/v1/mannequins/upload` tai generoi uusi AI-malli kutsulla `/api/v1/mannequins/generate-model`. Palautettu ID toimii suoraan sovituspyynnössä.
Miten kysyn tulosta?+
GET `/api/v1/tryon/apparel/:id` 3–5 sekunnin välein, kunnes `data.status` on `completed` tai `failed`. Aseta yläraja yrityksille — 120 × 3s kattaa dokumentoidun ikkunan reilusti.
Aiheeseen liittyvää
Liittyvät ominaisuudet
Vaatteet · Ominaisuus
Luo tili ja hanki API-avain
Phottan virtuaalinen sovitus-API hyväksyy vaatekuvan, mallitunnuksen ja asentotunnuksen, ja palauttaa 2K- tai 4K-mallikuvan. Tunnistautuminen tapahtuu `Authorization: Bearer photta_live_xxx` -otsakkeella, lähetä POST osoitteeseen `/api/v1/tryon/apparel`, pollata päätepistettä palautetulla tunnuksella 3–5 sekunnin välein ja lataa tulos, kun tila on `completed`.