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
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"]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')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"
}Parametry żądania
product_imageTyp: 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_labelTyp: stringWymagane
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_descriptionTyp: string
Extra guidance for the close-up. Max 400 characters.
framingTyp: 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-closeupsource_typeTyp: string
Tunes what is preserved in the close-up.
= apparel
Wartości:appareljewelry
Błędy
- 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.
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.
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.
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.
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`.
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.
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.
Ten sam endpoint w Node.js, Python i cURL
Node.js
API zdjęć detali produktu w Node.js
Wywołaj aPI zdjęć detali produktu od Photta z backendu Node.js za pomocą natywnego fetch. SDK nie jest wymagane: zapisz klucz, wyślij zadanie, odpytuj o wynik.
CzytajPython
API zdjęć detali produktu w Pythonie
Wywołuj Photta aPI zdjęć detali produktu w Pythonie za pomocą biblioteki requests. Trzydziestowierszowy wrapper, przyjazny dla async dzięki httpx, działa w Django, FastAPI i Celery.
CzytajcURL
API zdjęć detali produktu z cURL
Wywołuj aPI zdjęć detali produktu Photta bezpośrednio z powłoki za pomocą cURL. Wysyłaj, odpytuj, pobieraj — każdy fragment kodu współpracuje z jq w zautomatyzowanych potokach.
Czytaj
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
Możliwości
API wirtualnego try-on dla odzieży
REST API, które nakłada odzież na manekiny AI. Asynchroniczne, generowanie w 1.5–4 minuty, 5 credits przy 2K, 6 przy 4K. Przykłady dla cURL, Node.js i Python.
Zobacz endpointMożliwości
API try-on biżuterii dla naszyjników, pierścionków, bransoletek i kolczyków
Nakładaj naszyjniki, pierścionki, bransoletki i kolczyki na modele AI przez REST. 5 credits w 2K, wbudowane manekiny w zbliżeniu, renderowanie uwzględniające refleksy światła prosto z dokumentacji Photta.
Zobacz endpointTwórz
Zbuduj usługę fotografii produktowej AI
Playbook dla founderów dotyczący odsprzedaży API virtual try-on od Photta jako SaaS white-label: klucze tenantów, batch fanout, rozliczenia per-credit, realia SLA.
Zobacz endpointPorównaj
Photta vs FASHN — API AI dla branży fashion, zestawienie
Porównanie Photta i FASHN: endpointy, ceny credits, plany subskrypcyjne, limity współbieżności. Źródłem są oficjalne strony cenników obu firm z dnia 2026-04-19. Żadnych zmyślonych liczb.
Zobacz endpointSzybki start
Pierwszy obraz z Photta w mniej niż pięć minut.
Zarejestruj się, wygeneruj klucz API, wykonaj pierwsze wywołanie cURL, odpytuj aż do ukończenia, zapisz wynik. Pięć kroków opisanych od początku do końca.
Zobacz endpointDokumentacja
Błędy Photta API
Pełna lista typów błędów Photta API wraz z ich kodami statusu, strukturą treści błędu oraz informacją, które niepowodzenia warto ponowić.
Zobacz endpointDokumentacja
Rate limity Photta API
Rate limit Photta API, jego okno, nagłówek Retry-After, interwał dla pollingu oraz limity współbieżności według planu — wszystko prosto z dokumentacji API.
Zobacz endpoint
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