Photta API
Photta API virtuaalinen try-on, ghost mannequin ja tuotekuvaus RESTin kautta
Yhdellä lauseella
Photta API on credits-pohjainen REST API: tee POST tuotekuvasta kyvykkyyden endpointiin, tee polling sen tila-endpointiin muutaman sekunnin välein ja lataa valmis kuva. Kahdeksan kyvykkyyttä, yksi avain, yksi credits-saldo.
- Ominaisuudet: 8 ominaisuutta
- Rate limit: 600 pyyntöä/min
- Autentikointi: Bearer-avain
- Malli: asynkroninen, polling
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
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')const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"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."
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/tryon/apparel",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"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."
},
)
data = res.json()["data"] # data["id"], data["status"]Ominaisuudet
Jokainen endpoint kyvykkyyksittäin
Metodi, polku, credits ja tyypillinen aika suoraan API-dokumentaatiosta. Tämän sivun tiedot on tarkistettu dokumentaatiota vasten alareunassa näkyvänä päivämääränä.
- POST/api/v1/tryon/apparel
Virtuaalinen try-on (vaatteet)
Aseta flat-lay-vaate tekoälymallin päälle valitsemallasi ilmeellä ja vartalotyypillä. Neljä tuotetyyppiä, viisi kuvasuhdetta.
5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K1.5–4 min
Katso endpoint - POST/api/v1/tryon/jewelry
Korujen try-on
Tarkat lähikuvat kaulakoruista, sormuksista, rannekoruista ja korvakoruista varta vasten luoduilla korumalleilla — heijastukset ja pienet pinnat hallittuina.
5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K1.5–4 min
Katso endpoint - POST/api/v1/ghost-mannequin
Ghost mannequin
Poista mallinukke vaatekuvasta ja säilytä sisäpuolen rakenne ehjänä. 3D- tai flat-lay-viimeistely, eräajoyhteensopiva.
4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K1.5–4 min
Katso endpoint - POST/api/v1/ghost-mannequin/batch
Eräajona suoritettava ghost mannequin
Lähetä kokonainen rekki vaatekuvia yhdellä kutsulla ja pollaa yhtä batch ID:tä; jokainen kuva hinnoitellaan ja seurataan erikseen.
4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K1.5–4 min per image
Katso endpoint - POST/api/v1/eyewear-studio
Silmälasistudio
Silmälasit ja aurinkolasit renderöitynä lähikuvamalleille siten, että kehys vastaa tarkasti tuotekuvaasi.
5 credits resoluutiolla 2K · 6 credits resoluutiolla 4K20–60 sec
Katso endpoint - POST/api/v1/detail-photos
Yksityiskohtakuvat
Lähikuvat ompeleista, kankaasta, metalliosista ja lapuista yhdestä tuotekuvasta; analysaattori ehdottaa kuvattavat kohdat.
3 credits20–60 sec
Katso endpoint - POST/api/v1/mannequins/generate
Mallinuken luonti
Luo omat vaate- tai korumallit valintojen perusteella ja käytä niiden tunnisteita uudelleen jokaisessa try-on-kutsussa.
4 credits30-60s
Katso endpoint - POST/api/v1/workflows/{workflow_id}
Työnkulut
Aja esimääritetty työnkulku — esimerkiksi korun hero-kuva — yhdellä kutsulla ja saat valmiin kuvasarjan.
4 credits resoluutiolla 2K · 5 credits resoluutiolla 4K20–60 sec / image
Katso endpoint
Kielet
Ei vielä SDK:ta — etkä tarvitse sellaista.
Kolme suoraan kopioitavaa läpikäyntiä, jotka vastaavat täsmälleen sitä, mitä Photta-dokumentaatio suosittelee tänään.
Node.js
Node.js
Natiivi fetch Node 18+:ssa, 20-rivinen apufunktio, valmis Next.js-palvelintoimintoihin.
LuePython
Python
requests-kirjasto + 30-rivinen kääre. Toimii Django-, FastAPI-, Celery- ja Lambda-ympäristöissä.
LuecURL
cURL
Kahden minuutin savutesti mille tahansa endpointille. Toimii yhdessä jq:n kanssa shell-putkissa.
Lue
Pikaopas
Rekisteröitymisestä ensimmäiseen kuvaan viidessä minuutissa.
Jokainen kyvykkyys noudattaa samaa kaavaa: todenna, lähetä, tee polling. Opi se kerran.
Vaihe 1: Rekisteröidy osoitteessa ai.photta.app ja luo live-API-avain Developers-hallintapaneelista.
Vaihe 2: Tee POST työstä avaimesi ollessa Authorization-otsakkeessa — API palauttaa generointi-ID:n välittömästi.
Vaihe 3: Tee polling samaan endpointiin 3 sekunnin välein, kunnes tilaksi vaihtuu completed, ja lataa sitten tuloksen URL.
Kysymykset
Asioita, joita kehittäjät kysyvät ennen rekisteröitymistä
Mikä on Photta API?
Phottan API on credits-pohjainen REST-palvelu, joka generoi ammattitasoista muotikuvausta tuotekuvistasi. Se on sama putki, joka pyörittää Phottan kuluttajasovelluksia — virtuaalinen vaatteiden try-on, korujen try-on ja ghost mannequin -erotus — tuotuna kehittäjille kahdeksana kyvykkyytenä omien työkalujen rakentamiseen.
Miten saan API-avaimen?
Rekisteröidy osoitteessa ai.photta.app, avaa hallintapaneelin Developers-osio ja klikkaa Generate API key. Live-avaimesi alkaa merkkijonolla `photta_live_`, jota seuraa 32 heksadesimaalimerkkiä. Säilytä se ympäristömuuttujassa — älä koskaan commitoi sitä versionhallintaan äläkä toimita sitä selaimeen.
Onko saatavilla ilmaisversiota?
Uudet tilit saavat kokeilu-credits-saldoa, jota voit käyttää mihin tahansa kyvykkyyteen. Kun olet valmis tuotantoon, tilaa paketti, jossa on suurempi kuukausittainen credits-saldo. Rate limit on sama kaikissa paketeissa: 600 pyyntöä minuutissa per API-avain. Ei kutsukohtaisia vähimmäismääriä.
Kuinka nopeaa generointi on?
Try-on- ja ghost mannequin -työt valmistuvat tyypillisesti 1.5–4 minuutissa; silmälasikuvat, yksityiskohtakuvat ja työnkulkukuvat 20–60 sekunnissa; mallinuken generointi 30–60 sekunnissa. Jokainen generointi-endpoint on asynkroninen: POST palauttaa generointi-ID:n heti, ja teet pollingia 3–5 sekunnin välein, kunnes työ valmistuu. Avoinna pidettävää HTTP-yhteyttä ei tarvitse hallita.
Onko virallista Photta SDK:ta olemassa?
Ei vielä. Tuettu integraatiotapa on suora REST cURLin, Noden natiivin fetchin tai Pythonin requests-kirjaston kautta — kaikki kolme on dokumentoitu alusta loppuun tällä sivustolla jokaiselle kyvykkyydelle.
Referenssi
Dokumentaation osat, jotka avaat useammin kuin kerran.
Referenssi
Ensimmäinen Photta-kuva alle viidessä minuutissa.
Rekisteröidy, luo API-avain, suorita ensimmäinen cURL-kutsusi, tee pollingia valmistumiseen asti ja tallenna tulos. Viisi vaihetta, dokumentoitu alusta loppuun.
LueReferenssi
Photta API -autentikointi
Miten autentikoidutaan Photta APIin: Authorization-otsake, avaimen etuliite, mistä avaimet luodaan ja miten avain kierrätetään turvallisesti.
LueReferenssi
Photta API:n hinnoittelu
Mitä kukin Photta API -endpoint maksaa creditseinä resoluutioilla 2K ja 4K, miten veloitus ja palautukset toimivat ja mitkä endpointit ovat ilmaisia. Ei kuvakohtaista rahahintaa.
LueReferenssi
Photta API:n rate limitit
Photta API:n rate limit, sen aikaikkuna, Retry-After-otsake, pollausväli ja tilauskohtaiset rinnakkaisuusrajat, kaikki API-dokumentaatiosta luettuna.
LueReferenssi
Photta API -virheet
Täydellinen luettelo Photta API -virhetyypeistä statuskoodeineen, virheen rungon rakenne ja tiedot siitä, mitkä virheet kannattaa yrittää uudelleen.
LueReferenssi
Photta API -resurssipäätepisteet
Listaa mallinuket, asennot, taustat, jalkineet ja tuotemerkit, lataa omasi ja lue credits-saldosi. Haut jokaisen generoinnin takana.
LueOppaat
Mikä on virtual try-on -API?
Virtual try-on -API renderöi vaatteen mallin päälle yhdestä tuotekuvasta. Mitä se vaatii, mitä se palauttaa, mitä se maksaa ja kuinka kauan sen suoritus kestää.
LueOppaat
Mikä on ghost mannequin -API?
Ghost mannequin -API poistaa mallinuken vaatekuvasta ja rekonstruoi sisäpuolen. Mitä se vaatii, mitä se palauttaa ja mitä se maksaa.
LueOppaat
Migraatio FASHN-palvelusta Phottaan
Mikä muuttuu, kun siirrät virtuaalisen try-on-integraation FASHN-palvelusta Phottaan: autentikointi, pyynnön runko, polling ja miten credits-yksiköt veloitetaan.
LueRakenna
Rakenna Photta-rajapinnalla
Kahdeksan end-to-end-reseptiä Photta-rajapinnalle: try-on-sovellus, Shopify-sovellus, WooCommerce-lisäosa, Django-worker, eräajokatalogit ja no-code-automaatio.
LueVertailu
Parhaat virtual try-on -API:t
Miten viisi virtual try-on -API:a toimii — Photta, FASHN, FitRoom, Pixazo ja Ayna. Mitä kukin julkaisee, mitä ei, ja mistä lukea yksityiskohdat.
Lue
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
Kokeile APIa viidessä minuutissa
Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.
- 8 ominaisuutta
- 600 pyyntöä/min
- Bearer-avain
- asynkroninen, polling