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

POST/api/v1/detail-photos
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')

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')

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"
}

Request-parameters

product_image

Type: 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_label

Type: stringVereist

The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.

detail_description

Type: string

Extra guidance for the close-up. Max 400 characters.

framing

Type: 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-closeup
source_type

Type: string

Tunes what is preserved in the close-up.

= apparel

Waarden: appareljewelry

Errors

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_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.

  1. Stap 1

    Genereer een API-sleutel

    Detailfoto's gebruiken dezelfde inloggegevens en hetzelfde creditsaldo als elke andere functionaliteit van Photta.

  2. 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.

  3. 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.

  4. 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.

  5. Stap 5

    Download en bewaar

    De voltooide body bevat `output_url`. Detailfoto's passen direct in een PDP-galerij naast de hoofdafbeelding.

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

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