Photta API
Photta API virtuel try-on, ghost mannequin og produktfotografering via REST
I én sætning
Photta API er et credit-baseret REST API: POST et produktfoto til et capability-endpoint, poll dets status-endpoint med få sekunders mellemrum, download det færdige billede. Otte capabilities, én nøgle, én credits-saldo.
- Capabilities: 8 capabilities
- Rate limit: 600 requests/min
- Auth: Bearer key
- Mønster: async, polling
Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket
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"]Capabilities
Hvert endpoint, efter capability
Metode, sti, credits og typisk tidsforbrug, direkte fra API-dokumentationen. Fakta på denne side er verificeret mod dokumentationen på datoen angivet i bunden.
- POST/api/v1/tryon/apparel
Virtuel Try-On (beklædning)
Placér et flat-lay-stykke tøj på en AI-mannequin med det udtryk og den kropsstørrelse, du vælger. Fire produkttyper, fem billedformater.
5 credits ved 2K · 6 credits ved 4K1.5–4 min
Se endpointet - POST/api/v1/tryon/jewelry
Smykke Try-On
Tætte nærbilleder af halskæder, ringe, armbånd og øreringe på specialbyggede smykkemannequiner — refleksioner og bittesmå overflader håndteres præcist.
5 credits ved 2K · 6 credits ved 4K1.5–4 min
Se endpointet - POST/api/v1/ghost-mannequin
Ghost Mannequin
Fjern ginen fra et tøjbillede, og bevar den indvendige konstruktion intakt. 3D- eller flat-lay-finish, batch-optimeret.
4 credits ved 2K · 5 credits ved 4K1.5–4 min
Se endpointet - POST/api/v1/ghost-mannequin/batch
Batch Ghost Mannequin
Indsend et helt stativ af tøjbilleder i ét kald, og poll ét enkelt batch-ID; hvert billede afregnes og spores individuelt.
4 credits ved 2K · 5 credits ved 4K1.5–4 min per image
Se endpointet - POST/api/v1/eyewear-studio
Eyewear Studio
Briller og solbriller renderet på nærbilleder af modeller, hvor stellet forbliver 100 % tro mod dit produktbillede.
5 credits ved 2K · 6 credits ved 4K20–60 sec
Se endpointet - POST/api/v1/detail-photos
Detaljebilleder
Nærbilleder af syninger, stof, hardware og labels ud fra ét enkelt produktbillede; en analysator foreslår, hvilke områder der bør fremhæves.
3 credits20–60 sec
Se endpointet - POST/api/v1/mannequins/generate
Generering af mannequiner
Generér dine egne tøj- eller smykkemannequiner ud fra parametre, og genbrug derefter deres ID'er i hvert try-on-kald.
4 credits30-60s
Se endpointet - POST/api/v1/workflows/{workflow_id}
Workflows
Kør et foruddefineret workflow — f.eks. et smykke-heroshot — med ét enkelt kald, og få et færdigt sæt billeder retur.
4 credits ved 2K · 5 credits ved 4K20–60 sec / image
Se endpointet
Sprog
Ingen SDK endnu — og du behøver heller ikke én.
Tre gennemgange klar til at kopiere, som matcher præcis det, Photta-dokumentationen anbefaler i dag.
Node.js
Node.js
Native fetch i Node 18+, 20-linjers hjælpefunktion, klar til Next.js server actions.
LæsPython
Python
requests-bibliotek + en 30-linjers wrapper. Fungerer i Django, FastAPI, Celery, Lambda.
LæscURL
cURL
To minutters smoke test til ethvert endpoint. Kan kombineres med jq til shell pipelines.
Læs
Kvikstart
Fra oprettelse til første billede på fem minutter.
Hver capability følger det samme mønster: godkend, send, poll. Lær det én gang.
Trin 1: Opret en konto på ai.photta.app og generér en live API-nøgle fra Developers-kontrolpanelet.
Trin 2: POST jobbet med din nøgle i Authorization-headeren — API'et returnerer et generations-ID med det samme.
Trin 3: Poll det samme endpoint hvert 3. sekund, indtil status skifter til completed, og download derefter resultat-URL'en.
Spørgsmål
Ting, udviklere spørger om, før de opretter sig
Hvad er Photta API?
Phottas API er en credit-baseret REST-tjeneste, der genererer professionel modefotografering ud fra dine produktfotos. Det er den samme pipeline, som driver Phottas forbrugerapps — virtuel apparel try-on, smykke-try-on og ghost mannequin-udtræk, stillet til rådighed som otte capabilities, som udviklere kan bygge deres egne værktøjer ovenpå.
Hvordan får jeg en API-nøgle?
Opret en konto på ai.photta.app, åbn Developers-sektionen i kontrolpanelet, klik på Generate API key. Din live-nøgle starter med `photta_live_` efterfulgt af 32 hex-tegn. Gem den i en miljøvariabel — commit den aldrig til versionsstyring, send den aldrig til browseren.
Er der et gratis niveau?
Nye konti modtager prøve-credits, som du kan bruge på enhver capability. Når du er klar til at gå i produktion, tegner du abonnement på en plan med en højere månedlig credits-saldo. Rate limit er den samme på alle abonnementer: 600 anmodninger i minuttet pr. API-nøgle. Ingen minimumskrav pr. kald.
Hvor hurtig er genereringen?
Try-on- og ghost mannequin-jobs fuldføres typisk inden for 1.5 til 4 minutter; brillebilleder, detaljefotos og workflow-billeder på 20 til 60 sekunder; mannequin-generering på 30 til 60 sekunder. Hvert genererings-endpoint er asynkront: POST returnerer et generations-ID med det samme, og du poller hvert 3. til 5. sekund, indtil jobbet er færdigt. Der er ingen langvarig HTTP-forbindelse, der skal holdes åben.
Findes der en officiel Photta SDK?
Ikke endnu. Den understøttede integrationsvej er rå REST via cURL, Nodes native fetch eller Pythons requests-bibliotek — alle tre er dokumenteret fra start til slut på dette website for hver capability.
Reference
De dele af dokumentationen, du vil åbne mere end én gang.
Reference
Første Photta-billede på under fem minutter.
Opret en konto, generer en API-nøgle, kør dit første cURL-kald, foretag polling indtil det er fuldført, gem resultatet. Fem trin, dokumenteret fra start til slut.
LæsReference
Photta API-autentifikation
Sådan autentificerer du mod Photta API: Authorization-headeren, nøglepræfikset, hvor nøgler oprettes, og hvordan du roterer en sikkert.
LæsReference
Photta API-priser
Hvad hvert Photta API-endpoint koster i credits ved 2K og 4K, hvordan debitering og refundering fungerer, og hvilke endpoints der er gratis. Ingen faste pengepriser pr. billede.
LæsReference
Photta API rate limits
Photta API-rate limit, dets vindue, Retry-After-headeren, polling-intervallet og lofterne for samtidighed pr. abonnement, alt sammen aflæst fra API-dokumentationen.
LæsReference
Photta API-fejl
Den komplette liste over Photta API-fejltyper med deres statuskoder, strukturen på fejlsvaret, og hvilke fejl det kan betale sig at prøve igen.
LæsReference
Photta API-ressource-endpoints
Oplist giner, poseringer, baggrunde, fodtøj og brandlabels, upload dine egne, og aflæs din credits-saldo. Opslagene bag enhver generering.
LæsGuides
Hvad er et virtuelt try-on-API?
Et virtuelt try-on-API renderer en beklædningsgenstand på en model ud fra ét produktfoto. Hvad det modtager, hvad det returnerer, hvad det koster, og hvor lang tid det tager at køre.
LæsGuides
Hvad er et ghost mannequin-API?
Et ghost mannequin-API fjerner ginen fra et produktbillede og rekonstruerer indersiden. Hvad det kræver, hvad det returnerer, og hvad det koster.
LæsGuides
Migrering fra FASHN til Photta
Hvad der ændrer sig, når du flytter en virtuel try-on-integration fra FASHN til Photta: godkendelse, request body, polling og hvordan credits afregnes.
LæsByg
Byg med Photta API'et
Otte end-to-end-opskrifter til Photta API'et: en try-on-app, en Shopify-app, et WooCommerce-plugin, en Django-worker, batch-kataloger og no-code-automatisering.
LæsSammenlign
Bedste virtuelle try-on-API'er
Sådan fungerer fem virtuelle try-on-API'er — Photta, FASHN, FitRoom, Pixazo og Ayna. Hvad hver enkelt offentliggør, hvad de udelader, og hvor du kan læse detaljerne.
Læs
Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket
Prøv API'et på fem minutter
Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.
- 8 capabilities
- 600 requests/min
- Bearer key
- async, polling