Photta API

AI-muotikuvaus yhden REST-kutsun päässä.

Generoi vaate- ja korukuvia malleilla, poista mallinuket tuotekuvista ja rakenna oma tekoälypohjainen muotistudio Photta-tuotantoputken päälle — asynkroniset REST-päätepisteet, krediittiperusteinen hinnoittelu, cURL-pohjainen dokumentaatio.

Hanki API-avain→Lue dokumentaatio

Ominaisuudet

3

Auth

Bearer

Pattern

Async + poll

Tyypillinen

1–4 min

Ominaisuudet

Kolme päätepistettä, yksi tili, yksi krediittisaldo.

Jokainen ominaisuus jakaa saman todennuksen, kyselymallin ja virhemuodon — opettele yksi, hallitset kaikki kolme.

POST/api/v1/tryon/apparel

Virtuaalinen sovitus (vaatteet)

Aseta vaate tekoälymallin päälle valitsemassasi asennossa, ilmeessä ja ruumiinrakenteessa. Kuusi tuotetyyppiä, viisi kuvasuhdetta.

5 / 7 credits·~3 min
View capability →
POST/api/v1/tryon/jewelry

Korujen sovitus

Lähikuvat kaulakoruista, sormuksista, rannekoruista ja korvakoruista erityisesti koruille tarkoitetuilla malleilla — heijastukset ja pienet pinnat hallittu.

5 / 7 credits·~3 min
View capability →
POST/api/v1/ghost-mannequin

Ghost Mannequin

Poista mallinukke vaatekuvasta ja säilytä sisäpuolen rakenne ehjänä. Hollow-man- tai flat-lay-lopputulos, massaprosessointiin sopiva.

4 / 6 credits·~2 min
View capability →

Kielet

Ei vielä SDK:ta — etkä tarvitse sellaista.

Kolme valmiina kopioitavaa läpikäyntiä, jotka vastaavat täsmälleen sitä, mitä Photta-dokumentaatio suosittelee tänään.

javascript

→

Node.js

Natiivi fetch Node 18+:ssa, 20 rivin apufunktio, valmis Next.js server actions -käyttöön.

python

→

Python

requests-kirjasto + 30 rivin kääre. Toimii Django-, FastAPI-, Celery- ja Lambda-ympäristöissä.

bash

→

cURL

Kahden minuutin savutesti mille tahansa päätepisteelle. Käytä jq-työkalua komentoriviputkissa.

Pikaopas

Rekisteröitymisestä ensimmäiseen kuvaan viidessä minuutissa.

Jokainen ominaisuus noudattaa samaa kaavaa: todenna, lähetä, kysy tilannetta. Opi se kerran.

  • 1Rekisteröidy osoitteessa ai.photta.app ja generoi live API-avain kehittäjien hallintapaneelista.
  • 2POST-pyyntö avaimellasi Authorization-otsakkeessa — API palauttaa generointitunnuksen välittömästi.
  • 3Pollata samaa päätepistettä 3 sekunnin välein, kunnes tila muuttuu completed-tilaan, ja lataa sitten tulos URL-osoitteesta.
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": ["..."],
    "mannequin_id": "mnq_athena_ts",
    "pose_id": "pose_standing_front",
    "resolution": "2K"
  }'

Kysymyksiä

Kehittäjien yleisimmät kysymykset ennen rekisteröitymistä

Mikä on Photta API?+

Photta API on krediittiperusteinen REST-palvelu, joka generoi ammattimaisia muotikuvia tuotekuvistasi. Se on sama putki, joka antaa voiman Photta-kuluttajasovelluksille — virtuaalinen vaatesovitus, korujen sovitus ja ghost mannequin -generointi, tuotuna kolmena päätepisteenä kehittäjille 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 tunnisteella `photta_live_`, jota seuraa 32 heksamerkkiä. Säilytä se ympäristömuuttujassa — älä koskaan tallenna sitä versionhallintaan tai lähetä selaimeen.

Onko palvelussa ilmaista kokeilujaksoa?+

Uudet tilit saavat kokeilukrediittejä, joita voi käyttää mihin tahansa ominaisuuteen. Kun olet valmis julkaisuun, tilaa paketti, jossa on suurempi kuukausittainen krediittisaldo ja korkeammat nopeusrajoitukset (30/min Starter, 60/min Pro). Ei puhelukohtaisia minimiveloituksia; käyttämättömät krediitit eivät vanhene laskutuskauden aikana.

Kuinka nopeaa generointi on?+

Sovitustehtävät valmistuvat tyypillisesti 1.5–4 minuutissa. Ghost mannequin on nopeampi — yleensä 1–3 minuuttia. Jokainen päätepiste on asynkroninen: POST palauttaa tunnuksen alle sekunnissa, ja pollata tulosta 3–5 sekunnin välein valmistumiseen asti. Hallittavia pitkäkestoisia HTTP-yhteyksiä ei ole.

Onko olemassa virallista Photta SDK:ta?+

Ei vielä. Dokumentaation tiekartassa on Python SDK, kun API:lla on kymmenen aktiivista asiakasta, ja Node.js SDK kahdenkymmenen kohdalla. Siihen asti tuettu integraatiotapa on natiivi REST cURLilla, Noden natiivilla fetchillä tai Pythonin requests-kirjastolla — kaikki kolme on dokumentoitu täällä.

Photta API

Kokeile API:a viidessä minuutissa

Generoi Photta API-avain, liitä cURL-koodi ylhäältä, ja saat ensimmäisen mallikuvan ennen kuin kahvi ehtii valmistua.

Hanki API-avain →Lue dokumentaatio
Photta API — AI-muotikuvaus kehittäjille | Photta