Photta API
Photta API virtuell try-on, ghost mannequin og produktfotografering via REST
I én setning
Photta API er et kredittbasert REST API: POST et produktbilde til et capability-endpoint, poll status-endpointet hvert par sekunder, og last ned det ferdige bildet. Åtte capabilities, én nøkkel, én credit-saldo.
- Funksjoner: 8 funksjoner
- Rate limit: 600 forespørsler/min
- Autentisering: Bearer-nøkkel
- Mønster: asynkron, polling
Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert
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"]Funksjoner
Hvert endpoint, etter capability
Metode, sti, credits og typisk tid, hentet rett fra API-dokumentasjonen. Tallene på denne siden er kontrollert mot dokumentasjonen på datoen som vises nederst.
- POST/api/v1/tryon/apparel
Virtuell try-on (klær)
Plasser et flat-lay-plagg på en AI-mannekeng med det uttrykket og den kroppsstørrelsen du velger. Fire produkttyper, fem bildeformater.
5 credits ved 2K · 6 credits ved 4K1.5–4 min
Se endepunktet - POST/api/v1/tryon/jewelry
Smykke-try-on
Tette nærbilder av halskjeder, ringer, armbånd og øredobber på spesialbygde smykkemannekenger — refleksjoner og ørsmå overflater håndteres.
5 credits ved 2K · 6 credits ved 4K1.5–4 min
Se endepunktet - POST/api/v1/ghost-mannequin
Ghost mannequin
Fjern utstillingsdukken fra et klesbilde og behold den innvendige konstruksjonen intakt. 3D- eller flat-lay-finish, batch-vennlig.
4 credits ved 2K · 5 credits ved 4K1.5–4 min
Se endepunktet - POST/api/v1/ghost-mannequin/batch
Batch ghost mannequin
Send inn et helt stativ med klesbilder i ett kall og polle én batch-ID; hvert bilde prises og spores for seg selv.
4 credits ved 2K · 5 credits ved 4K1.5–4 min per image
Se endepunktet - POST/api/v1/eyewear-studio
Brillestudio
Briller og solbriller gjengitt på modeller i nærbilde, der innfatningen holdes tro mot produktbildet ditt.
5 credits ved 2K · 6 credits ved 4K20–60 sec
Se endepunktet - POST/api/v1/detail-photos
Detaljbilder
Nærbilder av sømmer, stoff, metalldeler og etiketter fra ett produktbilde; en analysator foreslår hvilke områder som bør fotograferes.
3 credits20–60 sec
Se endepunktet - POST/api/v1/mannequins/generate
Mannekeng-generering
Generer dine egne kles- eller smykkemannekenger fra alternativer, og gjenbruk ID-ene deres i hvert try-on-kall.
4 credits30-60s
Se endepunktet - POST/api/v1/workflows/{workflow_id}
Arbeidsflyter
Kjør en forhåndsdefinert arbeidsflyt — for eksempel et hero-bilde for smykker — med ett kall, og få et ferdig sett med bilder.
4 credits ved 2K · 5 credits ved 4K20–60 sec / image
Se endepunktet
Språk
Ingen SDK ennå — og du trenger ingen.
Tre gjennomganger klare til å limes inn, som samsvarer nøyaktig med det Photta-dokumentasjonen anbefaler i dag.
Node.js
Node.js
Innfødt fetch i Node 18+, 20-linjers hjelpefunksjon, klar for serverhandlinger i Next.js.
LesPython
Python
requests-biblioteket + en 30-linjers wrapper. Fungerer i Django, FastAPI, Celery, Lambda.
LescURL
cURL
To minutters røyktest for ethvert endpoint. Kan kombineres med jq for shell-pipelines.
Les
Hurtigstart
Fra registrering til første bilde på fem minutter.
Hver capability følger samme mønster: autentiser, send inn, poll. Lær det én gang.
Trinn 1: Registrer deg på ai.photta.app og generer en live-API-nøkkel fra Developers-dashbordet.
Trinn 2: POST jobben med nøkkelen din i Authorization-headeren — API-et returnerer en genererings-ID umiddelbart.
Trinn 3: Poll det samme endpointet hvert 3. sekund til status endres til completed, og last deretter ned resultat-URL-en.
Spørsmål
Ting utviklere spør om før de registrerer seg
Hva er Photta API?
Phottas API er en kredittbasert REST-tjeneste som genererer profesjonell motefotografering fra produktbildene dine. Det er den samme pipelinen som driver Phottas forbrukerapper — virtuell apparel-try-on, smykke-try-on og ghost mannequin-ekstraksjon, eksponert som åtte capabilities som utviklere kan bygge egne verktøy på toppen av.
Hvordan får jeg en API-nøkkel?
Registrer deg på ai.photta.app, åpne Developers-seksjonen i dashbordet, og klikk på Generate API key. Live-nøkkelen din starter med `photta_live_` etterfulgt av 32 hex-tegn. Oppbevar den i en miljøvariabel — aldri sjekk den inn i kildekodekontroll, og send den aldri til nettleseren.
Finnes det et gratisnivå?
Nye kontoer mottar prøve-credits du kan bruke på enhver capability. Når du er klar til å rulle ut, abonnerer du på en plan med en høyere månedlig credit-saldo. Rate limit-en er den samme på alle planer: 600 requests per minutt per API-nøkkel. Ingen minimumskrav per kall.
Hvor rask er genereringen?
Try-on- og ghost mannequin-jobber fullføres vanligvis innen 1,5 til 4 minutter; brillebilder, detaljbilder og workflow-bilder på 20 til 60 sekunder; mannequin-generering på 30 til 60 sekunder. Hvert genererings-endpoint er asynkront: POST returnerer en genererings-ID umiddelbart, og du poller hvert 3. til 5. sekund til jobben er ferdig. Det er ingen langvarig HTTP-tilkobling å håndtere.
Finnes det en offisiell Photta SDK?
Ikke ennå. Den støttede integrasjonsmåten er rå REST via cURL, Nodes innfødte fetch eller Pythons requests-bibliotek — alle tre er dokumentert fra ende til annen på dette nettstedet, for hver capability.
Referanse
Delene av dokumentasjonen du kommer til å åpne mer enn én gang.
Referanse
Første Photta-bilde på under fem minutter.
Registrer deg, generer en API-nøkkel, kjør ditt første cURL-kall, utfør polling til det er fullført, lagre resultatet. Fem trinn, dokumentert fra start til slutt.
LesReferanse
Photta API-autentisering
Slik autentiserer du mot Photta API: Authorization-headeren, nøkkelprefikset, hvor nøkler opprettes, og hvordan du roterer en nøkkel trygt.
LesReferanse
Photta API-priser
Hva hvert Photta API-endepunkt koster i credits ved 2K og 4K, hvordan trekk og refusjoner fungerer, og hvilke endepunkter som er gratis. Ingen pengepris per bilde.
LesReferanse
Photta API rate limits
Photta API-ets rate limit, tidsvinduet, Retry-After-headeren, polling-intervallet og grensene for samtidighet per plan, alt hentet fra API-dokumentasjonen.
LesReferanse
Photta API-feil
Den fullstendige listen over Photta API-feiltyper med deres statuskoder, strukturen på en feilrespons, og hvilke feil det er verdt å prøve på nytt.
LesReferanse
Photta API-ressursendepunkter
List utstillingsdukker, positurer, bakgrunner, fottøy og merkevareetiketter, last opp dine egne og les av saldoen for credits. Oppslagene bak hver generering.
LesGuider
Hva er et API for virtuell try-on?
Et API for virtuell try-on rendrer et klesplagg på en modell basert på ett enkelt produktbilde. Hva det tar inn, hva det returnerer, hva det koster og hvor lenge det kjører.
LesGuider
Hva er et ghost mannequin-API?
Et ghost mannequin-API fjerner ginen fra et plaggbilde og rekonstruerer innsiden. Hva det krever, hva det returnerer og hva det koster.
LesGuider
Migrering fra FASHN til Photta
Hva som endres når du flytter en virtuell try-on-integrasjon fra FASHN til Photta: autentisering, request body, polling og hvordan credits belastes.
LesBygg
Bygg med Photta-API-et
Åtte ende-til-ende-oppskrifter for Photta-API-et: en try-on-app, en Shopify-app, en WooCommerce-plugin, en Django-worker, batch-kataloger og no-code-automatisering.
LesSammenlign
Beste API-er for virtuell try-on
Hvordan fem API-er for virtuell try-on fungerer — Photta, FASHN, FitRoom, Pixazo og Ayna. Hva hver av dem publiserer, hva de ikke publiserer, og hvor du kan lese detaljene.
Les
Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert
Prøv API-et på fem minutter
Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.
- 8 funksjoner
- 600 forespørsler/min
- Bearer-nøkkel
- asynkron, polling