Yetenek · Detay fotoğrafları
Ürün detay fotoğrafı API'si yakın çekimler için
Tek cümlede
Photta'nın detay fotoğrafı API'si, bir ürünün belirtilen tek bir alanının yakın çekimini işler. Ücretsiz bir analyze çağrısı çekilmeye değer detayları önerir; generate çağrısı ise çözünürlük katmanları olmadan sabit 3 credits tutarındadır.
- Tipik süre: 20–60 sec
- Credits: 3 credits
- İşleme: asenkron, polling
- Sınırlar: 600 istek/dk
- Kimlik doğrulama: Bearer anahtarı
Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi
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"]Genel bakış
Genel bakış
- Endpoint
- POST /api/v1/detail-photos
- Kimlik doğrulama
- Bearer API anahtarı
- İşleme
- Asenkron — durum endpoint'ini sorgulayın (poll)
- Tipik süre
- 20–60 sec
- Credits
- 3 credits
- Girdi sınırları
- Görsel başına en fazla 10 MB; JPEG, PNG, WebP
- Idempotent
- Hayır
İstek ve yanıt
İstek
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"
}İstek parametreleri
product_imageTür: stringZorunlu
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_labelTür: stringZorunlu
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_descriptionTür: string
Extra guidance for the close-up. Max 400 characters.
framingTür: 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
Değerler:extreme-closeupcloseupmedium-closeupsource_typeTür: string
Tunes what is preserved in the close-up.
= apparel
Değerler:appareljewelry
Hatalar
- 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.
Sınırlar
- API anahtarı başına dakikada 600 istek (Sabit pencere; limit her planda aynıdır)
- 429 yanıtı Retry-After: 30 saniye içerir
- Görsel başına en fazla 10 MB
- Formatlar: JPEG, PNG, WebP
- Plan başına eşzamanlı toplu işlem: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Yalnızca polling — API webhook göndermez.
Neyin çekilmeye değer olduğunu sorun, ardından çekin
Ücretsiz analiz edin, bir detay seçin, gönderin, poll edin, indirin.
Adım 1
Bir API anahtarı oluşturun
Detay fotoğrafları, diğer tüm Photta yetenekleriyle aynı kimlik bilgilerini ve aynı credit bakiyesini kullanır.
Adım 2
Hangi detayların çekileceğini sorun
`product_image` ile POST `/api/v1/detail-photos/analyze` isteği atın. İlgili ürün için önerilen `detail_label`, `detail_description` ve `framing` değerlerini senkron olarak döndürür ve hiçbir ücret almaz.
Adım 3
Yakın çekimi POST edin
`product_image` ve `detail_label` ile `/api/v1/detail-photos` adresine POST isteği atın. `framing` değerini `extreme-closeup`, `closeup` veya `medium-closeup`, `source_type` değerini `apparel` veya `jewelry` olarak ayarlayın ve 400 karaktere kadar `detail_description` ekleyin.
Adım 4
İşlem tamamlanana kadar poll edin
`data.status` değeri `completed` veya `failed` olana kadar her 3 saniyede bir GET `/api/v1/detail-photos/:id` isteği atın; tipik tamamlanma süresi 20 ila 60 saniyedir.
Adım 5
İndirin ve kalıcı hale getirin
Tamamlanan gövde `output_url` değerini taşır. Detay fotoğrafları, PDP galerisinde doğrudan ana çekimin yanına yerleşir.
Node.js, Python ve cURL'de aynı endpoint
Node.js
Node.js'te Ürün detay fotoğrafı API'si
Yerel fetch ile bir Node.js backend'inden Photta'nın ürün detay fotoğrafı API'si özelliğini çağırın. SDK gerekmez: anahtarınızı saklayın, işi gönderin, sonuç için poll edin.
OkuPython
Python'da Ürün detay fotoğrafı API'si
Photta'nın ürün detay fotoğrafı API'si özelliğini requests kütüphanesiyle Python'da çağırın. Otuz satırlık sarmalayıcı, httpx ile asenkron uyumlu, Django, FastAPI ve Celery içinde çalışır.
OkucURL
cURL ile Ürün detay fotoğrafı API'si
Photta'nın ürün detay fotoğrafı API'si özelliğini cURL ile doğrudan kabuktan çağırın. Gönderin, yoklayın, indirin — her kod parçacığı betik tabanlı işlem hatları için jq ile uyumludur.
Oku
Geliştiricilerin detay fotoğraflarını yayına almadan önce sorduğu sorular
Detay fotoğrafı API'si nedir?
Makro lensle ikinci bir stüdyo çekimi yapmak yerine, tek bir geniş açı fotoğraftan ürünün belirtilen bir alanının — yaka dikişi, toka, göğüsteki dokuma — yakın çekimini işleyen bir endpoint'tir.
Bir detay fotoğrafının maliyeti nedir?
Sabit 3 credits. Bu endpoint'te çözünürlük katmanları yoktur ve detay öneren analyze çağrısı ücretsizdir.
Analyze endpoint'i ne döndürür?
Her biri bir `detail_label`, o alanın neden gösterilmeye değer olduğunu açıklayan bir `detail_description` ve önerilen bir `framing` içeren bir öneri listesi döndürür. Herhangi bir öneriyi doğrudan generate çağrısına besleyin.
Her bir kadraj seçeneği ne kadar yakındır?
`extreme-closeup` karenin neredeyse tamamını detayla doldurur, `closeup` detayın etrafında bir miktar bağlam bırakır ve `medium-closeup` detayı çevreleyen giysi veya parça içinde gösterir. Ürün bazında değil, detay bazında seçim yapın.
Kaynak görsel yapay zeka ile üretilmiş olabilir mi?
Evet. `product_image`, tamamlanmış bir üretimin `output_url` değerini ve ayrıca https URL veya base64 data URI formatındaki herhangi bir ürün fotoğrafınızı kabul eder.
Sonuç için nasıl polling yapabilirim?
`data.status` değeri `completed` veya `failed` olana kadar her 3 saniyede bir GET `/api/v1/detail-photos/:id` isteği atın. Analiz çağrısı senkrondur ve polling gerektirmez.
İlgili yetenekler
Yetenekler
Sanal try-on API'si giyim için
Giysileri yapay zeka mankenlerine yerleştiren REST API. Asenkron, 1.5–4 dakika oluşturma süresi, 2K için 5 credits, 4K için 6 credits. cURL, Node.js ve Python örnekleri.
Endpoint'i görüntüleyinYetenekler
Takı try-on API'si kolyeler, yüzükler, bilezikler ve küpeler için
REST aracılığıyla kolyeleri, yüzükleri, bilezikleri ve küpeleri yapay zeka modellerine yerleştirin. 2K'da 5 credits, dahili yakın çekim mankenler, Photta dokümantasyonundan yansıma duyarlı render.
Endpoint'i görüntüleyinGeliştir
Bir yapay zeka ürün fotoğrafçılığı servisi geliştirin
Photta'nın sanal try-on API'sini white-label bir SaaS olarak satmaya yönelik bir kurucu rehberi: kiracı anahtarları, toplu dağıtım, credit başına faturalandırma, SLA gerçekleri.
Endpoint'i görüntüleyinKarşılaştır
Photta vs FASHN — AI moda API'si, yan yana
Photta ve FASHN karşılaştırması: endpoint'ler, kredi fiyatlandırması, plan katmanları, eşzamanlılık limitleri. Her iki şirketin de 2026-04-19 tarihindeki kendi fiyatlandırma sayfalarından derlenmiştir. Uydurma rakamlar yoktur.
Endpoint'i görüntüleyinHızlı başlangıç
Beş dakikadan kısa sürede ilk Photta görseli.
Kayıt olun, bir API anahtarı oluşturun, ilk cURL çağrınızı çalıştırın, tamamlanana kadar yoklayın, sonucu kalıcı hale getirin. Beş adım, uçtan uca belgelenmiş.
Endpoint'i görüntüleyinReferans
Photta API hataları
Durum kodlarıyla birlikte Photta API hata tiplerinin tam listesi, bir hata gövdesinin yapısı ve hangi hataların yeniden denenmeye değer olduğu.
Endpoint'i görüntüleyinReferans
Photta API rate limit'leri
Tümü API dokümantasyonundan alınan Photta API rate limit'i, penceresi, Retry-After başlığı, polling aralığı ve plan başına eşzamanlılık sınırları.
Endpoint'i görüntüleyin
Bu sayfadaki her veri şuradan alınmıştır: Photta API dokümantasyonu · kontrol edildi
API'yi beş dakikada deneyin
Bir Photta API key oluşturun, yukarıdaki cURL kod parçacığını yapıştırın; kahveniz demlenmeden önce model üzerindeki ilk görselinizi alın.
- 20–60 sec
- 3 credits
- asenkron, polling
- 600 istek/dk
- Bearer anahtarı