Funksjonalitet · Batch ghost mannequin
Batch ghost mannequin-API for hele varekataloger
I én setning
Phottas batch ghost mannequin-endpoint tar en array med klesbilder og returnerer en batch-id pluss én element-id per bilde. Credits for hele batchen reserveres på forhånd; poll batchen for en aggregert status.
- Typisk tidsbruk: 1.5–4 min per image
- Credits: 4 credits ved 2K · 5 credits ved 4K
- Prosessering: asynkron, polling
- Grenser: 600 forespørsler/min
- Autentisering: Bearer-nøkkel
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/ghost-mannequin/batch \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin/batch", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/ghost-mannequin/batch",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
},
)
data = res.json()["data"] # data["id"], data["status"]
Kort oppsummert
Kort oppsummert
- Endepunkt
- POST /api/v1/ghost-mannequin/batch
- Autentisering
- Bearer API-nøkkel
- Prosessering
- Asynkron – poll status-endepunktet
- Typisk tidsbruk
- 1.5–4 min per image
- Credits
- 4 credits ved 2K · 5 credits ved 4K
- Bildeformater
- 3:4 · 1:1 · 4:3 · 9:16 · 16:9
- Inndatagrenser
- Opptil 10 MB per bilde; JPEG, PNG, WebP
- Idempotent
- Nei
Forespørsel og respons
Forespørsel
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin/batch \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin/batch", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/ghost-mannequin/batch",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_images": [
{
"image": "https://cdn.yourstore.com/products/jacket-front.jpg",
"back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/shirt-front.jpg",
"image_side": "front"
},
{
"image": "https://cdn.yourstore.com/products/trousers-front.jpg",
"image_side": "front"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"user_instruction": "closed front, buttoned up",
"brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
},
)
data = res.json()["data"] # data["id"], data["status"]202 Accepted / completed
{
"data": {
"batch_id": "gmb_x7y8z9",
"status": "processing",
"total": 3,
"completed": 0,
"failed": 0,
"items": [
{
"id": "gm_p1q2r3",
"status": "processing"
},
{
"id": "gm_s4t5u6",
"status": "processing"
},
{
"id": "gm_v7w8x9",
"status": "processing"
}
],
"style": "3d",
"background_color": "white",
"resolution": "2K",
"aspect_ratio": "3:4",
"credits_reserved": 12,
"created_at": "2026-04-10T16:05:00Z"
},
"request_id": "req_gmb001"
}{
"data": {
"batch_id": "gmb_x7y8z9",
"status": "completed",
"total": 3,
"completed": 3,
"failed": 0,
"processing": 0,
"credits_reserved": 12,
"credits_used": 12,
"credits_refunded": 0,
"items": [
{
"id": "gm_p1q2r3",
"status": "completed",
"output_url": "https://cdn.photta.app/generated/gm_p1q2r3.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/gm_p1q2r3-thumb.jpg",
"credits_used": 4,
"completed_at": "2026-04-10T16:06:42Z",
"duration_ms": 102000
},
{
"id": "gm_s4t5u6",
"status": "completed",
"output_url": "https://cdn.photta.app/generated/gm_s4t5u6.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/gm_s4t5u6-thumb.jpg",
"credits_used": 4,
"completed_at": "2026-04-10T16:08:18Z",
"duration_ms": 96000
},
{
"id": "gm_v7w8x9",
"status": "completed",
"output_url": "https://cdn.photta.app/generated/gm_v7w8x9.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/gm_v7w8x9-thumb.jpg",
"credits_used": 4,
"completed_at": "2026-04-10T16:09:50Z",
"duration_ms": 92000
}
],
"created_at": "2026-04-10T16:05:00Z",
"completed_at": "2026-04-10T16:09:50Z"
},
"request_id": "req_gmbs002"
}Forespørselsparametere
product_imagesType: array[object]Påkrevd
Array of image objects. Each object contains "image" (URL or base64), optional "back_image", and optional "image_side". API batch caps (5× the dashboard limit): Free/Hobby/Hobby v2 5, Seller/Starter 10, Brand/Pro 25, Studio/Premium 50.
angleType: string
Applied to all images. "side" reconstructs the side view from each front photo (plus back_image when provided) — see the single-generate endpoint for details.
= straight
Verdier:straightbacksidestyleType: string
Applied to all images.
= 3d
Verdier:3dflat_laybackground_colorType: string
Applied to all images.
= white
Verdier:whitegraybeigeblackresolutionType: string
Applied to all images. "2K" = 4 credits each. "4K" = 5 credits each. 4K is produced natively in a single generation per item — pick it upfront; the resolution cannot be changed after creation. Note: 4K cannot be combined with aspect_ratio 1:1 — that combination returns 400.
= 2K
Verdier:2K4Kaspect_ratioType: string
Applied to all images. Note: 1:1 is not available at 4K resolution — 1:1 combined with 4K returns 400.
= 3:4
Verdier:3:41:14:39:1616:9user_instructionType: string
Batch-level: one note applied to every item. Optional free-form string, max 400 characters (anything longer is silently truncated). A guarded steer for ambiguous rendering choices — e.g. "closed front", "cream interior lining", "buttoned up" — it never overrides the source garment, brand label, or structural reconstruction, and it is explicitly NOT a determinism/seed control.
brand_label_idType: string
Applied to all images. Brand label UUID returned by the Brand Labels API. API v1 request fields use snake_case; use brand_label_id.
Feil
- 400
invalid_request_error - The request is malformed or contains invalid parameters.
- 401
authentication_error - The API key is missing, invalid, or expired.
- 402
insufficient_credits_error - Your account does not have enough credits.
- 404
not_found_error - The requested resource does not exist.
- 409
conflict_error - The request conflicts with current state — e.g. your concurrent-batch cap is reached.
- 429
rate_limit_error - Too many requests. Slow down and retry.Retry-After: 30
- 500
api_error - An internal server error occurred. Retry later.
Grenser
- 600 forespørsler per minutt per API-nøkkel (Fast tidsvindu; grensen er lik for alle abonnementer)
- En 429 inneholder Retry-After: 30 sekunder
- Opptil 10 MB per bilde
- Formater: JPEG, PNG, WebP
- Samtidige batcher per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Kun polling – API-et sender ikke webhooks.
Én forespørsel, et helt klesstativ
Sett sammen arrayen, send inn én gang, poll batchen, last ned hvert element.
Trinn 1
Generer en API-nøkkel
Batch ghost mannequin bruker samme autentisering og samme credit-saldo som all annen Photta-funksjonalitet.
Trinn 2
Sett sammen bildearrayen
`product_images` tar ett objekt per plagg: `image`, pluss valgfri `back_image` og `image_side`. API-ets batchgrense er 5 bilder på Free og Hobby, 10 på Seller, 25 på Brand og 50 på Studio.
Trinn 3
POST batchen
POST `/api/v1/ghost-mannequin/batch`. `angle`, `style`, `background_color`, `resolution` og `aspect_ratio` gjelder for alle elementer, og `user_instruction` legger til ett notat på opptil 400 tegn for samtlige. Credits for hele batchen reserveres før det første elementet genereres.
Trinn 4
Poll batchen
GET `/api/v1/ghost-mannequin/batch/:id` hvert 3. sekund. Responsen inneholder `total`, `completed`, `failed` og en oppdeling per element, slik at du kan begynne nedlastingen før det siste plagget er ferdig.
Trinn 5
Last ned hvert resultat
Hvert fullførte element har sin egen `output_url`, `credits_used` og tidsbruk. Elementer som feiler refunderer sine reserverte credits og rapporteres i `credits_refunded`.
Samme endpoint i Node.js, Python og cURL
Node.js
Batch ghost mannequin-API i Node.js
Kall Phottas batch ghost mannequin-API fra en Node.js-backend med native fetch. Ingen SDK nødvendig: lagre nøkkelen din, send inn jobben, poll etter resultatet.
LesPython
Batch ghost mannequin-API i Python
Kall Phottas batch ghost mannequin-API i Python med requests-biblioteket. Tretti linjers wrapper, async-vennlig via httpx, fungerer i Django, FastAPI og Celery.
LescURL
Batch ghost mannequin-API med cURL
Kall Phottas batch ghost mannequin-API direkte fra kommandolinjen med cURL. Send inn, poll, last ned — alle kodesnutter kan kombineres med jq for skriptede pipelines.
Les
Spørsmål utviklere stiller før de kjører batcher
Hva tilfører batch-endpointet?
Det godtar en array med klesbilder i én enkelt forespørsel og behandler dem i bakgrunnen. Du får en batch-id for den aggregerte visningen og en element-id per bilde, i stedet for å spore dusinvis av separate jobber.
Hvor mange bilder får plass i én batch?
API-ets batchgrense er 5 bilder på Free og Hobby, 10 på Seller, 25 på Brand og 50 på Studio — fem ganger grensen i dashbordet. En batch som er større enn planen din tillater, returnerer 400.
Hvordan belastes credits for en batch?
Hele batchen reserveres på forhånd: antall bilder multiplisert med prisen per bilde, 4 credits i 2K eller 5 i 4K. Hvis saldoen ikke dekker reservasjonen, returnerer forespørselen 402 og ingenting genereres.
Hva skjer hvis ett element feiler?
Resten av batchen fortsetter. Batch-responsen rapporterer `failed` sammen med `completed`, og de reserverte creditsene for feilede elementer tilbakeføres i `credits_refunded`.
Hvor mange batcher kan kjøre samtidig?
Samtidige aktive batcher er begrenset av planen: Free 1, Hobby 2, Seller 3, Brand 4 og Studio 6. Overskrides grensen returneres 409 — poll den aktive batchen til den er ferdig, og send inn på nytt.
Hvordan poller jeg en batch?
GET `/api/v1/ghost-mannequin/batch/:id` hvert 3. sekund for aggregert status, eller poll et enkelt element på standardstatusstien for ghost mannequin når du trenger detaljer per plagg.
Relatert funksjonalitet
Funksjoner
Ghost mannequin-API for hollow-man-produktbilder
AI ghost mannequin-endepunkt. Fjern mannekengen fra et klesbilde og bevar innvendige detaljer. 3D eller flat-lay, batch-prosessering, 4 credits i 2K.
Se endepunktetFunksjoner
Virtuell try-on API for klær
REST API som plasserer klær på AI-mannequiner. Asynkront, 1,5–4 minutters generering, 5 credits i 2K, 6 i 4K. Eksempler for cURL, Node.js og Python.
Se endepunktetBygg
Automatiser uthenting av usynlig dukke for katalogen din
Oppskrift for nattlig katalogautomatisering: hent gårsdagens produktoppdateringer, send i batch til Phottas ghost-mannequin-API, poll overordnet batch, lagre i databasen din.
Se endepunktetSammenlign
Photta vs Pixazo — førsteparts-pipeline eller modellaggregator
Photta vs Pixazo sammenlignet: førsteparts fashion-pipeline vs flermodell-aggregator. Endepunkter, latens, gratisnivå og avveininger. Innhentet 2026-04-19.
Se endepunktetHurtigstart
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.
Se endepunktetReferanse
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.
Se endepunktetReferanse
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.
Se endepunktet
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.
- 1.5–4 min per image
- 4 credits ved 2K · 5 credits ved 4K
- asynkron, polling
- 600 forespørsler/min
- Bearer-nøkkel