Photta API
Photta API virtuell try-on, ghost mannequin och produktfotografering via REST
I en mening
Photta API är ett kreditbaserat REST API: POST:a en produktbild till en funktions-endpoint, polla dess status-endpoint med några sekunders mellanrum, ladda ner den färdiga bilden. Åtta förmågor, en nyckel, ett kreditsaldo.
- Funktioner: 8 funktioner
- Rate limit: 600 requests/min
- Autentisering: Bearer-nyckel
- Mönster: asynkron, polling
Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad
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"]Funktioner
Varje endpoint, efter förmåga
Metod, sökväg, credits och typisk tidsåtgång, direkt från API-dokumentationen. Fakta på denna sida är kontrollerade mot dokumentationen det datum som visas längst ner.
- POST/api/v1/tryon/apparel
Virtual Try-On (Kläder)
Placera ett flat-lay-plagg på en AI-docka med det ansiktsuttryck och den kroppsstorlek du väljer. Fyra produkttyper, fem bildförhållanden.
5 credits vid 2K · 6 credits vid 4K1.5–4 min
Se endpoint - POST/api/v1/tryon/jewelry
Try-on för smycken
Täta närbilder på halsband, ringar, armband och örhängen på specialanpassade smyckesdockor — reflektioner och minimala ytor hanteras automatiskt.
5 credits vid 2K · 6 credits vid 4K1.5–4 min
Se endpoint - POST/api/v1/ghost-mannequin
Ghost Mannequin
Ta bort provdockan från en plaggbild och bevara insidans konstruktion intakt. 3D- eller flat-lay-finish, batch-anpassat.
4 credits vid 2K · 5 credits vid 4K1.5–4 min
Se endpoint - POST/api/v1/ghost-mannequin/batch
Batch Ghost Mannequin
Skicka in ett helt plaggställ med produktbilder i ett enda anrop och polla ett batch-ID; varje bild prissätts och spåras separat.
4 credits vid 2K · 5 credits vid 4K1.5–4 min per image
Se endpoint - POST/api/v1/eyewear-studio
Eyewear Studio
Vanliga glasögon och solglasögon renderade på närbildsmodeller där bågen förblir trogen din produktbild.
5 credits vid 2K · 6 credits vid 4K20–60 sec
Se endpoint - POST/api/v1/detail-photos
Detaljbilder
Närbilder på sömmar, tyg, detaljer och etiketter från en enda produktbild; en analysator föreslår vilka områden som ska fotas.
3 credits20–60 sec
Se endpoint - POST/api/v1/mannequins/generate
Generera provdockor
Generera egna provdockor för kläder eller smycken utifrån parametrar, och återanvänd sedan deras ID:n i varje try-on-anrop.
4 credits30-60s
Se endpoint - POST/api/v1/workflows/{workflow_id}
Arbetsflöden
Kör ett förinställt arbetsflöde — exempelvis en hero-bild för smycken — med ett enda anrop och få en färdig uppsättning bilder.
4 credits vid 2K · 5 credits vid 4K20–60 sec / image
Se endpoint
Språk
Ingen SDK ännu — och du behöver ingen.
Tre genomgångar klara att klistra in, som matchar exakt vad Phottas dokumentation rekommenderar idag.
Node.js
Node.js
Inbyggd fetch i Node 18+, hjälparfunktion på 20 rader, redo för Next.js server actions.
LäsPython
Python
requests-biblioteket + en wrapper på 30 rader. Fungerar i Django, FastAPI, Celery, Lambda.
LäscURL
cURL
Tvåminuters smoke-test för alla endpoints. Kombineras med jq för pipelines i skalet.
Läs
Snabbstart
Från registrering till första bilden på fem minuter.
Varje förmåga följer samma mönster: autentisera, skicka, polla. Lär dig det en gång.
Steg 1: Registrera dig på ai.photta.app och generera en live API-nyckel från Developers-översikten.
Steg 2: Skicka jobbet via POST med din nyckel i Authorization-headern — API:et returnerar ett genererings-ID direkt.
Steg 3: Polla samma endpoint var 3:e sekund tills status slår om till completed, ladda sedan ned resultatets URL.
Frågor
Saker utvecklare frågar innan de registrerar sig
Vad är Photta API?
Phottas API är en kreditbaserad REST-tjänst som genererar professionell modefotografering från dina produktbilder. Det är samma pipeline som driver Phottas konsumentappar — virtuell try-on för kläder, try-on för smycken och ghost mannequin-extrahering, exponerade som åtta förmågor för utvecklare att bygga egna verktyg ovanpå.
Hur skaffar jag en API-nyckel?
Registrera dig på ai.photta.app, öppna sektionen Developers i instrumentpanelen och klicka på Generate API key. Din live-nyckel börjar med `photta_live_` följt av 32 hexadecimala tecken. Spara den i en miljövariabel — checka aldrig in den i källkodshantering och skicka den aldrig till webbläsaren.
Finns det en gratisnivå?
Nya konton får provkrediter som du kan spendera på valfri förmåga. När du är redo för produktion tecknar du en plan med ett högre månatligt kreditsaldo. Rate limiten är densamma på alla planer: 600 anrop per minut per API-nyckel. Inga miniminivåer per anrop.
Hur snabb är genereringen?
Try-on och ghost mannequin-jobb blir vanligtvis klara inom 1,5 till 4 minuter; glasögonbilder, detaljfoton och arbetsflödesbilder på 20 till 60 sekunder; mannekänggenerering på 30 till 60 sekunder. Varje genererings-endpoint är asynkron: POST returnerar ett genererings-ID omedelbart, och du pollar var 3:e till 5:e sekund tills jobbet är klart. Det finns ingen långvarig HTTP-anslutning att hantera.
Finns det en officiell Photta SDK?
Inte ännu. Den integration som stöds är ren REST via cURL, Nodes inbyggda fetch eller Pythons requests-bibliotek — alla tre är dokumenterade från början till slut på den här webbplatsen, för varje förmåga.
Referens
Delarna av dokumentationen du kommer att öppna mer än en gång.
Referens
Första Photta-bilden på under fem minuter.
Skapa konto, generera en API-nyckel, kör ditt första cURL-anrop, polla tills det är klart, spara resultatet. Fem steg, dokumenterade från början till slut.
LäsReferens
Photta API-autentisering
Hur du autentiserar mot Photta API: Authorization-headern, nyckelprefixet, var nycklar skapas och hur du roterar en på ett säkert sätt.
LäsReferens
Photta API-prissättning
Vad varje Photta API-endpoint kostar i credits i 2K och 4K, hur debitering och återbetalning fungerar, samt vilka endpoints som är gratis. Inget fast pris i pengar per bild.
LäsReferens
Photta API rate limits
Photta API:s rate limit, dess fönster, Retry-After-headern, polling-intervallet och taken för samtidighet per abonnemang, allt hämtat från API-dokumentationen.
LäsReferens
Photta API-fel
Den fullständiga listan över feltyper i Photta API med deras statuskoder, strukturen på ett felmeddelande, och vilka fel som är värda att försöka igen.
LäsReferens
Photta API-resursendpoints
Lista mannekänger, poser, bakgrunder, skor och varumärkesetiketter, ladda upp dina egna och läs av ditt credits-saldo. Uppslagningarna bakom varje generering.
LäsGuider
Vad är ett API för virtuell try-on?
Ett API för virtuell try-on renderar ett plagg på en modell utifrån ett enda produktfoto. Vad det tar emot, vad det returnerar, vad det kostar och hur lång tid det tar.
LäsGuider
Vad är ett ghost mannequin-API?
Ett ghost mannequin-API tar bort dockan från ett plaggfoto och rekonstruerar insidan. Vad som krävs, vad det returnerar och vad det kostar.
LäsGuider
Migrera från FASHN till Photta
Vad som ändras när du flyttar en virtuell try-on-integration från FASHN till Photta: autentisering, request body, polling och hur credits debiteras.
LäsBygg
Bygg med Photta API:et
Åtta heltäckande recept för Photta API:et: en try-on-app, en Shopify-app, ett WooCommerce-tillägg, en Django-worker, batchkataloger och no-code-automatisering.
LäsJämför
Bästa API:er för virtuell try-on
Hur fem API:er för virtuell try-on fungerar — Photta, FASHN, FitRoom, Pixazo och Ayna. Vad var och en publicerar, vad de utelämnar och var du kan läsa detaljerna.
Läs
Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad
Testa API:et på fem minuter
Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.
- 8 funktioner
- 600 requests/min
- Bearer-nyckel
- asynkron, polling