Förmåga · Detaljfoton

API för produktdetaljbilder för närbilder

I en mening

Phottas detaljfotobaserade API renderar en närbild av ett namngivet område på en produkt. Ett gratis analyze-anrop föreslår detaljer värda att plåta; generate-anropet kostar fast 3 credits, utan upplösningsnivåer.

  • Typisk tid: 20–60 sec
  • Credits: 3 credits
  • Bearbetning: asynkron, polling
  • Gränser: 600 requests/min
  • Autentisering: Bearer-nyckel

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

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

I korthet

I korthet

Endpoint
POST /api/v1/detail-photos
Autentisering
Bearer API-nyckel
Bearbetning
Asynkron — polla status-endpointen
Typisk tid
20–60 sec
Credits
3 credits
Indatagränser
Upp till 10 MB per bild; JPEG, PNG, WebP
Idempotent
Nej

Request och 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-parametrar

product_image

Typ: stringObligatorisk

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

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

Värden: extreme-closeupcloseupmedium-closeup
source_type

Typ: string

Tunes what is preserved in the close-up.

= apparel

Värden: appareljewelry

Fel

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.

Gränser

  • 600 anrop per minut per API-nyckel (Fast fönster; gränsen är densamma på alla planer)
  • En 429 innehåller Retry-After: 30 sekunder
  • Upp till 10 MB per bild
  • Format: JPEG, PNG, WebP
  • Samtidiga batcher per plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
  • Endast polling — API:et skickar inga webhooks.

Fråga vad som är värt att plåta, och plåta det sedan

Analysera gratis, välj en detalj, skicka in, polla, ladda ner.

  1. Steg 1

    Generera en API-nyckel

    Detaljfoton använder samma inloggningsuppgifter och samma credit-saldo som alla andra förmågor i Photta.

  2. Steg 2

    Fråga vilka detaljer som ska plåtas

    Gör POST till `/api/v1/detail-photos/analyze` med `product_image`. Den returnerar föreslagna värden för `detail_label`, `detail_description` och `framing` för den produkten, synkront och utan kostnad.

  3. Steg 3

    Gör en POST för närbilden

    Gör POST till `/api/v1/detail-photos` med `product_image` och `detail_label`. Sätt `framing` till `extreme-closeup`, `closeup` eller `medium-closeup`, `source_type` till `apparel` eller `jewelry`, och lägg till upp till 400 tecken som `detail_description`.

  4. Steg 4

    Polla tills jobbet är klart

    Gör GET mot `/api/v1/detail-photos/:id` var 3:e sekund tills `data.status` är `completed` eller `failed`; typisk tid till slutförande är 20 till 60 sekunder.

  5. Steg 5

    Ladda ner och spara

    Det färdiga svaret innehåller `output_url`. Detaljfoton passar direkt in i ett PDP-galleri bredvid huvudbilden.

Frågor utvecklare ställer innan de driftsätter detaljfoton

Vad är ett API för detaljfoton?

En endpoint som renderar en närbild av ett namngivet område på en produkt — kragsömmen, ett spänne, väven på bröstet — från ett enda bredare fotografi, i stället för ytterligare en studiosession med makroobjektiv.

Hur mycket kostar ett detaljfoto?

Fast 3 credits. Det finns inga upplösningsnivåer på denna endpoint, och analyze-anropet som föreslår detaljer är gratis.

Vad returnerar analyze-endpointen?

En lista med förslag, var och en med en `detail_label`, en `detail_description` som förklarar varför området är värt att visa, samt en rekommenderad `framing`. Skicka vilket förslag som helst direkt in i generate-anropet.

Hur snäv är respektive beskärning?

`extreme-closeup` fyller nästan hela bildytan med detaljen, `closeup` behåller lite kontext runt den, och `medium-closeup` visar detaljen i det omgivande plagget eller smycket. Välj per detalj, inte per produkt.

Kan källan vara en genererad bild?

Ja. `product_image` accepterar `output_url` från en slutförd generering såväl som vilket eget produktfoto som helst, som en https-URL eller en base64-data-URI.

Hur pollar jag efter resultatet?

Gör GET mot `/api/v1/detail-photos/:id` var 3:e sekund tills `data.status` är `completed` eller `failed`. Analysanropet är synkront och kräver ingen polling.

Relaterade förmågor

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Testa API:et på fem minuter

Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.

  • 20–60 sec
  • 3 credits
  • asynkron, polling
  • 600 requests/min
  • Bearer-nyckel