Funktionalitet · Detaljebilleder

API til produktdetaljebilleder til nærbilleder

I én sætning

Phottas detaljefoto-API renderer et nærbillede af ét navngivet område på et produkt. Et gratis analyze-kald foreslår detaljer, der er værd at fotografere; generate-kaldet koster en fast pris på 3 credits uden opløsningsniveauer.

Hent en API-nøgle Læs dokumentationen

Typisk tid: 20–60 sec
Credits: 3 credits
Behandling: async, polling
Grænser: 600 requests/min
Autentifikation: Bearer key

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket 2026-09-10

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

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

import 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"]

Kort fortalt

Endpoint: POST /api/v1/detail-photos
Autentifikation: Bearer API-nøgle
Behandling: Asynkron — poll status-endpointet
Typisk tid: 20–60 sec
Credits: 3 credits
Inputgrænser: Op til 10 MB pr. billede; JPEG, PNG, WebP
Idempotent: Nej

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

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

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

Request-parametre

FeltBeskrivelse

product_image

Type: stringPåkrævet

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

Type: stringPåkrævet

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

detail_description

Type: string

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

framing

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

extreme-closeupcloseupmedium-closeup

source_type

Type: string

Tunes what is preserved in the close-up.

= apparel

appareljewelry

Fejl

StatusTypeBetydning

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 anmodninger i minuttet pr. API-nøgle (Fast vindue; grænsen er den samme på alle planer)
En 429 indeholder Retry-After: 30 sekunder
Op til 10 MB pr. billede
Formater: JPEG, PNG, WebP
Samtidige batches pr. plan: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Kun polling — API'et sender ingen webhooks.

Spørg, hvad der er værd at fotografere, og tag så billedet

Analysér gratis, vælg en detalje, indsend, poll, download.

Trin 1
Generér en API-nøgle
Detaljebilleder bruger de samme legitimationsoplysninger og den samme credit-saldo som enhver anden Photta-funktionalitet.
Trin 2
Spørg, hvilke detaljer der skal fotograferes
POST `/api/v1/detail-photos/analyze` med `product_image`. Det returnerer synkront foreslåede værdier for `detail_label`, `detail_description` og `framing` for det pågældende produkt og koster ingenting.
Trin 3
POST nærbilledet
POST til `/api/v1/detail-photos` med `product_image` og `detail_label`. Sæt `framing` til `extreme-closeup`, `closeup` eller `medium-closeup`, `source_type` til `apparel` eller `jewelry`, og tilføj op til 400 tegn af `detail_description`.
Trin 4
Poll, indtil jobbet er fuldført
GET `/api/v1/detail-photos/:id` hvert 3. sekund, indtil `data.status` er `completed` eller `failed`; typisk fuldførelsestid er 20 til 60 sekunder.
Trin 5
Download og persistér
Det fuldførte body-respons indeholder `output_url`. Detaljebilleder passer direkte ind i et PDP-galleri ved siden af hovedbilledet.

Det samme endpoint i Node.js, Python og cURL

Spørgsmål, udviklere stiller, før de deployer detaljebilleder

Hvad er et API til detaljebilleder?

Et endpoint, der renderer et nærbillede af ét navngivet område på et produkt — kravesyningen, en lås, vævningen på brystet — ud fra et enkelt bredere fotografi i stedet for en ekstra studiosession med et makroobjektiv.

Hvad koster et detaljebillede?

Fast 3 credits. Der er ingen opløsningsniveauer på dette endpoint, og analyze-kaldet, der foreslår detaljer, er gratis.

Hvad returnerer analyze-endpointet?

En liste over forslag, hver med et `detail_label`, en `detail_description`, der forklarer, hvorfor området er værd at vise, og en anbefalet `framing`. Før ethvert forslag direkte videre til generate-kaldet.

Hvor tæt beskæring har hver framing-mulighed?

`extreme-closeup` udfylder næsten hele billedet med detaljen, `closeup` bevarer lidt kontekst omkring den, og `medium-closeup` viser detaljen i det omgivende tøj eller smykke. Vælg pr. detalje, ikke pr. produkt.

Kan kilden være et genereret billede?

Ja. `product_image` accepterer `output_url` fra en fuldført generering samt ethvert af dine egne produktfotos, som en https-URL eller en base64-data-URI.

Hvordan poller jeg efter resultatet?

GET `/api/v1/detail-photos/:id` hvert 3. sekund, indtil `data.status` er `completed` eller `failed`. Analyse-kaldet er synkront og kræver ingen polling.

Relaterede funktionaliteter

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket 2026-09-10

Prøv API'et på fem minutter

Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.

Opret en konto og hent en API-nøgle Læs dokumentationen

20–60 sec
3 credits
async, polling
600 requests/min
Bearer key

API til produktdetaljebilleder til nærbilleder

Kort fortalt

Request og response

Request-parametre

Fejl

Spørg, hvad der er værd at fotografere, og tag så billedet

Generér en API-nøgle

Spørg, hvilke detaljer der skal fotograferes

POST nærbilledet

Poll, indtil jobbet er fuldført

Download og persistér

Det samme endpoint i Node.js, Python og cURL

Spørgsmål, udviklere stiller, før de deployer detaljebilleder

Relaterede funktionaliteter

Prøv API'et på fem minutter