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

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

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

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

İstek parametreleri

product_image

Tü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_label

Tür: stringZorunlu

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

detail_description

Tür: string

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

framing

Tü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-closeup
source_type

Tür: string

Tunes what is preserved in the close-up.

= apparel

Değerler: appareljewelry

Hatalar

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.

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.

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

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

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

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

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

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

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ı