Możliwość · Zdjęcia detali

API zdjęć detali produktu do zbliżeń

W jednym zdaniu

API zdjęć detali Photta renderuje zbliżenie jednego wskazanego obszaru produktu. Bezpłatne wywołanie analizujące sugeruje detale warte sfotografowania; wywołanie generujące kosztuje stałe 3 credits, bez progów rozdzielczości.

  • Typowy czas: 20–60 sec
  • Credits: 3 credits
  • Przetwarzanie: asynchroniczne, polling
  • Limity: 600 requests/min
  • Uwierzytelnianie: Klucz Bearer

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

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

W skrócie

W skrócie

Endpoint
POST /api/v1/detail-photos
Uwierzytelnianie
Klucz API Bearer
Przetwarzanie
Asynchroniczne — odpytuj endpoint statusu
Typowy czas
20–60 sec
Credits
3 credits
Limity wejściowe
Do 10 MB na obraz; JPEG, PNG, WebP
Idempotentne
Nie

Żądanie i odpowiedź

Żądanie

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

Parametry żądania

product_image

Typ: stringWymagane

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

Typ: stringWymagane

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

detail_description

Typ: string

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

framing

Typ: 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

Wartości: extreme-closeupcloseupmedium-closeup
source_type

Typ: string

Tunes what is preserved in the close-up.

= apparel

Wartości: appareljewelry

Błędy

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.

Limity

  • 600 żądań na minutę na klucz API (Stałe okno czasowe; limit jest taki sam w każdym planie)
  • Odpowiedź 429 zawiera nagłówek Retry-After: 30 s
  • Do 10 MB na obraz
  • Formaty: JPEG, PNG, WebP
  • Jednoczesne zadania wsadowe w zależności od planu: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Tylko polling — API nie wysyła webhooków.

Zapytaj, co warto sfotografować, a następnie zrób zdjęcie

Analizuj bezpłatnie, wybierz detal, wyślij zadanie, odpytuj i pobierz wynik.

  1. Krok 1

    Wygeneruj klucz API

    Zdjęcia detali korzystają z tych samych danych uwierzytelniających i tego samego salda credits, co każda inna funkcja Photta.

  2. Krok 2

    Zapytaj, które detale sfotografować

    Wyślij POST `/api/v1/detail-photos/analyze` z parametrem `product_image`. Zwraca synchronicznie sugerowane wartości `detail_label`, `detail_description` oraz `framing` dla danego produktu i nie pobiera żadnych opłat.

  3. Krok 3

    Wyślij żądanie zbliżenia metodą POST

    Wyślij POST do `/api/v1/detail-photos` z parametrami `product_image` i `detail_label`. Ustaw `framing` na `extreme-closeup`, `closeup` lub `medium-closeup`, `source_type` na `apparel` lub `jewelry`, oraz dodaj do 400 znaków w `detail_description`.

  4. Krok 4

    Odpytuj, aż zadanie zostanie zakończone

    Wykonuj GET `/api/v1/detail-photos/:id` co 3 sekundy, aż `data.status` przyjmie wartość `completed` lub `failed`; typowy czas realizacji to od 20 do 60 sekund.

  5. Krok 5

    Pobierz i zapisz

    Odpowiedź po ukończeniu zadania zawiera `output_url`. Zdjęcia detali pasują bezpośrednio do galerii PDP obok głównego ujęcia.

Pytania zadawane przez programistów przed wdrożeniem zdjęć detali

Czym jest API do zdjęć detali?

Endpointem, który renderuje zbliżenie jednego wskazanego obszaru produktu — szwów kołnierzyka, zapięcia, splotu na klatce piersiowej — z pojedynczego, szerszego zdjęcia, zamiast kolejnej sesji w studio z obiektywem makro.

Ile kosztuje zdjęcie detalu?

Stałe 3 credits. Na tym endpoincie nie ma progów rozdzielczości, a wywołanie analizujące, które sugeruje detale, jest bezpłatne.

Co zwraca endpoint analizy?

Listę sugestii, każda z parametrami `detail_label`, `detail_description` wyjaśniającym, dlaczego warto pokazać dany obszar, oraz rekomendowanym `framing`. Przekaż dowolną sugestię bezpośrednio do wywołania generującego.

Jak ciasna jest każda opcja kadrowania?

`extreme-closeup` wypełnia niemal cały kadr detalem, `closeup` zachowuje wokół niego nieco kontekstu, a `medium-closeup` pokazuje detal na tle otaczającej odzieży lub przedmiotu. Dobieraj dla każdego detalu, nie per produkt.

Czy obrazem źródłowym może być wygenerowana grafika?

Tak. `product_image` przyjmuje `output_url` ukończonej generacji, a także dowolne własne zdjęcie produktu w postaci adresu URL https lub data URI w base64.

Jak odpytywać (poll) o wynik?

Wywołuj GET `/api/v1/detail-photos/:id` co 3 sekundy, dopóki `data.status` nie zmieni się na `completed` lub `failed`. Wywołanie analyze jest synchroniczne i nie wymaga pollingu.

Powiązane możliwości

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono

Wypróbuj API w 5 minut

Wygeneruj klucz Photta API, wklej powyższy snippet cURL, a otrzymasz swoje pierwsze zdjęcie na modelu, zanim zaparzy się kawa.

  • 20–60 sec
  • 3 credits
  • asynchroniczne, polling
  • 600 requests/min
  • Klucz Bearer