Functionaliteit · Detailfoto's
Productdetailfoto-API voor close-ups
In één zin
Photta's detailfoto-API rendert een close-up van één benoemd deel van een product. Een gratis analyze-call suggereert details die de moeite waard zijn om vast te leggen; de generate-call kost vast 3 credits, zonder resolutieniveaus.
- Typische duur: 20–60 sec
- Credits: 3 credits
- Verwerking: async, polling
- Limieten: 600 requests/min
- Authenticatie: Bearer key
Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/detail-photos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/detail-photos",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
},
)
data = res.json()["data"] # data["id"], data["status"]In één oogopslag
In één oogopslag
- Endpoint
- POST /api/v1/detail-photos
- Authenticatie
- Bearer API key
- Verwerking
- Asynchroon — poll het status-endpoint
- Typische duur
- 20–60 sec
- Credits
- 3 credits
- Invoerlimieten
- Tot 10 MB per afbeelding; JPEG, PNG, WebP
- Idempotent
- Nee
Request en response
Request
RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/detail-photos \
-H "Authorization: Bearer $PHOTTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')const res = await fetch("https://api.photta.app/api/v1/detail-photos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
}),
});
const { data } = await res.json(); // data.id, data.statusimport os, requests
res = requests.post(
"https://api.photta.app/api/v1/detail-photos",
headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
json={
"product_image": "https://cdn.yourstore.com/products/linen-shirt-hero.jpg",
"detail_label": "collar stitching",
"detail_description": "Focus on the reinforced double-stitch seam along the collar edge.",
"framing": "extreme-closeup",
"source_type": "apparel"
},
)
data = res.json()["data"] # data["id"], data["status"]202 Accepted / Completed
{
"data": {
"id": "dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10",
"status": "processing",
"detail_label": "collar stitching",
"framing": "extreme-closeup",
"credits_used": 3,
"created_at": "2026-07-30T14:20:00Z"
},
"request_id": "req_dtl001"
}{
"data": {
"id": "dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10",
"status": "completed",
"detail_label": "collar stitching",
"framing": "extreme-closeup",
"output_url": "https://cdn.photta.app/generated/dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10.jpg",
"thumbnail_url": "https://cdn.photta.app/generated/dtl_9f2c4a71b8e3d605a1f7c2948d3b6e10-thumb.jpg",
"credits_used": 3,
"created_at": "2026-07-30T14:20:00Z",
"completed_at": "2026-07-30T14:20:42Z",
"duration_ms": 42000
},
"request_id": "req_dtl003"
}Request-parameters
product_imageType: stringVereist
The source image — a completed generation's output_url or any product photo. https URL or base64 data URI. JPEG, PNG, WebP; max 10 MB.
detail_labelType: stringVereist
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_descriptionType: string
Extra guidance for the close-up. Max 400 characters.
framingType: string
How tight the crop is: "extreme-closeup" — the detail fills ~90% of the frame (near-macro); "closeup" — ~70% with some surrounding context; "medium-closeup" — ~50% with body/outfit visible.
= medium-closeup
Waarden:extreme-closeupcloseupmedium-closeupsource_typeType: string
Tunes what is preserved in the close-up.
= apparel
Waarden:appareljewelry
Errors
- 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.
Limieten
- 600 verzoeken per minuut per API key (Vast venster; de limiet is identiek op elk abonnement)
- Een 429 bevat Retry-After: 30 seconden
- Tot 10 MB per afbeelding
- Formaten: JPEG, PNG, WebP
- Gelijktijdige batches per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Uitsluitend polling — de API stuurt geen webhooks.
Vraag wat de moeite waard is om vast te leggen, en schiet het vervolgens
Analyseer gratis, kies een detail, verzend, poll, download.
Stap 1
Genereer een API-sleutel
Detailfoto's gebruiken dezelfde inloggegevens en hetzelfde creditsaldo als elke andere functionaliteit van Photta.
Stap 2
Vraag welke details te fotograferen
POST `/api/v1/detail-photos/analyze` met `product_image`. Het retourneert synchroon voorgestelde waarden voor `detail_label`, `detail_description` en `framing` voor dat product, en kost niets.
Stap 3
POST de close-up
POST naar `/api/v1/detail-photos` met `product_image` en `detail_label`. Stel `framing` in op `extreme-closeup`, `closeup` of `medium-closeup`, `source_type` op `apparel` of `jewelry`, en voeg maximaal 400 tekens aan `detail_description` toe.
Stap 4
Poll totdat de taak is voltooid
GET `/api/v1/detail-photos/:id` elke 3 seconden totdat `data.status` `completed` of `failed` is; typische doorlooptijd is 20 tot 60 seconden.
Stap 5
Download en bewaar
De voltooide body bevat `output_url`. Detailfoto's passen direct in een PDP-galerij naast de hoofdafbeelding.
Hetzelfde endpoint in Node.js, Python en cURL
Node.js
Productdetailfoto-API in Node.js
Roep Photta's productdetailfoto-API aan vanuit een Node.js-backend met native fetch. Geen SDK vereist: sla je sleutel op, verzend de taak, poll voor het resultaat.
LezenPython
Productdetailfoto-API in Python
Roep Photta's productdetailfoto-API aan in Python met de requests-bibliotheek. Een wrapper van dertig regels, async-vriendelijk via httpx, werkt in Django, FastAPI en Celery.
LezencURL
Productdetailfoto-API met cURL
Roep Photta's productdetailfoto-API direct aan vanuit de shell met cURL. Verzenden, pollen, downloaden — elk fragment werkt naadloos samen met jq voor gescripte pipelines.
Lezen
Vragen die developers stellen voor het live zetten van detailfoto's
Wat is een detailfoto-API?
Een endpoint dat een close-up rendert van één specifiek deel van een product — het kraagstiksel, een sluiting, de textuur op de borst — op basis van één enkele wijdere foto, in plaats van een tweede studiosessie met een macrolens.
Hoeveel kost een detailfoto?
Vast 3 credits. Er zijn geen resolutieniveaus op dit endpoint, en de analyze-call die details suggereert is gratis.
Wat levert het analyze-endpoint op?
Een lijst met suggesties, elk met een `detail_label`, een `detail_description` die uitlegt waarom dat deel de moeite waard is om te tonen, en een aanbevolen `framing`. Geef elke suggestie direct door aan de generate-call.
Hoe strak is elke framing-optie gekaderd?
`extreme-closeup` vult bijna het hele beeld met het detail, `closeup` behoudt een beetje context eromheen, en `medium-closeup` toont het detail binnen het omliggende kledingstuk of sieraad. Kies per detail, niet per product.
Kan de bron een gegenereerde afbeelding zijn?
Ja. `product_image` accepteert de `output_url` van een voltooide generatie en elke eigen productfoto, als een https-URL of een base64-data-URI.
Hoe poll ik voor het resultaat?
GET `/api/v1/detail-photos/:id` elke 3 seconden totdat `data.status` `completed` of `failed` is. De analyze-aanroep is synchroon en vereist geen polling.
Gerelateerde functionaliteiten
Mogelijkheden
Virtual try-on API voor kleding
REST API die kleding op AI-mannequins plaatst. Asynchroon, generatie in 1.5–4 minuten, 5 credits bij 2K, 6 bij 4K. Voorbeelden in cURL, Node.js en Python.
Bekijk het endpointMogelijkheden
Sieraden try-on API voor kettingen, ringen, armbanden en oorbellen
Plaats kettingen, ringen, armbanden en oorbellen op AI-modellen via REST. 5 credits bij 2K, ingebouwde close-up mannequins, reflectie-bewuste rendering uit de Photta-documentatie.
Bekijk het endpointBouwen
Bouw een AI-dienst voor productfotografie
Een playbook voor founders om de virtuele try-on API van Photta door te verkopen als een white-label SaaS: tenant-sleutels, batch-distributie, facturatie per credit en de realiteit rond SLA's.
Bekijk het endpointVergelijken
Photta vs FASHN — AI-mode-API, zij aan zij
Photta en FASHN vergeleken: endpoints, creditprijzen, abonnementsniveaus, concurrency-limieten. Afkomstig van de officiële prijzenpagina van elk bedrijf op 2026-04-19. Geen verzonnen cijfers.
Bekijk het endpointSnelstartgids
Eerste Photta-afbeelding in minder dan vijf minuten.
Registreer je, genereer een API-sleutel, voer je eerste cURL-call uit, poll totdat deze is voltooid, sla het resultaat op. Vijf stappen, end-to-end gedocumenteerd.
Bekijk het endpointReferentie
Photta API-fouten
De volledige lijst van Photta API-fouttypen met hun statuscodes, de structuur van een foutbody, en welke fouten het waard zijn om opnieuw te proberen.
Bekijk het endpointReferentie
Photta API rate limits
De Photta API rate limit, het bijbehorende venster, de Retry-After-header, het polling-interval en de gelijktijdigheidslimieten per abonnement, rechtstreeks uit de API-documentatie.
Bekijk het endpoint
Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd
Probeer de API in vijf minuten
Genereer een Photta API-sleutel, plak het bovenstaande cURL-fragment en je hebt je eerste afbeelding op een model voordat de koffie klaar is.
- 20–60 sec
- 3 credits
- async, polling
- 600 requests/min
- Bearer key