Funksjonalitet · Detaljbilder

API for produktdetaljbilder for nærbilder

I én setning

Phottas API for detaljbilder genererer et nærbilde av ett navngitt område på et produkt. Et gratis analyse-kall foreslår detaljer som er verdt å fotografere; generate-kallet koster 3 credits fast, uten oppløsningsnivåer.

Få en API-nøkkel Les dokumentasjonen

Typisk tidsbruk: 20–60 sec
Credits: 3 credits
Prosessering: asynkron, polling
Grenser: 600 forespørsler/min
Autentisering: Bearer-nøkkel

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 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 oppsummert

Endepunkt: POST /api/v1/detail-photos
Autentisering: Bearer API-nøkkel
Prosessering: Asynkron – poll status-endepunktet
Typisk tidsbruk: 20–60 sec
Credits: 3 credits
Inndatagrenser: Opptil 10 MB per bilde; JPEG, PNG, WebP
Idempotent: Nei

Forespørsel og respons

Forespørsel

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

Forespørselsparametere

FeltBeskrivelse

product_image

Type: stringPåkrevd

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åkrevd

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

Feil

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.

Grenser

600 forespørsler per minutt per API-nøkkel (Fast tidsvindu; grensen er lik for alle abonnementer)
En 429 inneholder Retry-After: 30 sekunder
Opptil 10 MB per bilde
Formater: JPEG, PNG, WebP
Samtidige batcher per abonnement: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
Kun polling – API-et sender ikke webhooks.

Spør hva som er verdt å fotografere, og ta deretter bildene

Analyser gratis, velg en detalj, send inn, poll, last ned.

Trinn 1
Generer en API-nøkkel
Detaljbilder bruker samme autentisering og samme credit-saldo som all annen Photta-funksjonalitet.
Trinn 2
Spør hvilke detaljer som bør fotograferes
POST `/api/v1/detail-photos/analyze` med `product_image`. Den returnerer foreslåtte verdier for `detail_label`, `detail_description` og `framing` for det produktet, synkront og helt gratis.
Trinn 3
POST nærbildet
POST til `/api/v1/detail-photos` med `product_image` og `detail_label`. Sett `framing` til `extreme-closeup`, `closeup` eller `medium-closeup`, `source_type` til `apparel` eller `jewelry`, og legg til opptil 400 tegn med `detail_description`.
Trinn 4
Poll til jobben er fullført
Kjør GET `/api/v1/detail-photos/:id` hvert 3. sekund til `data.status` er `completed` eller `failed`; typisk fullføringstid er 20 til 60 sekunder.
Trinn 5
Last ned og lagre
Den fullførte responsen inneholder `output_url`. Detaljbilder passer rett inn i et PDP-galleri ved siden av hovedbildet.

Samme endepunkt i Node.js, Python og cURL

Spørsmål utviklere stiller før de ruller ut detaljbilder

Hva er et API for detaljbilder?

Et endepunkt som genererer et nærbilde av ett navngitt område på et produkt — kragesømmen, en spenne, vevingen på brystet — fra et enkelt oversiktsbilde, i stedet for en ny studiofotografering med makroobjektiv.

Hvor mye koster et detaljbilde?

3 credits fast. Det er ingen oppløsningsnivåer på dette endepunktet, og analyse-kallet som foreslår detaljer er gratis.

Hva returnerer analyse-endepunktet?

En liste med forslag, hver med en `detail_label`, en `detail_description` som forklarer hvorfor området er verdt å vise frem, og en anbefalt `framing`. Send ethvert forslag rett inn i generate-kallet.

Hvor tett utsnitt har hvert framing-alternativ?

`extreme-closeup` fyller nesten hele bildet med detaljen, `closeup` bevarer litt kontekst rundt den, og `medium-closeup` viser detaljen i det omkringliggende plagget eller smykket. Velg per detalj, ikke per produkt.

Kan kildebildet være et generert bilde?

Ja. `product_image` godtar både `output_url` fra en fullført generering og et hvilket som helst eget produktbilde, som en https-URL eller en base64 data-URI.

Hvordan poller jeg etter resultatet?

GET `/api/v1/detail-photos/:id` hvert 3. sekund til `data.status` er `completed` eller `failed`. Analyze-kallet er synkront og krever ingen polling.

Relatert funksjonalitet

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert 2026-09-10

Prøv API-et på fem minutter

Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.

Opprett en konto og få en API-nøkkel Les dokumentasjonen

20–60 sec
3 credits
asynkron, polling
600 forespørsler/min
Bearer-nøkkel

API for produktdetaljbilder for nærbilder

Kort oppsummert

Forespørsel og respons

Forespørselsparametere

Feil

Spør hva som er verdt å fotografere, og ta deretter bildene

Generer en API-nøkkel

Spør hvilke detaljer som bør fotograferes

POST nærbildet

Poll til jobben er fullført

Last ned og lagre

Samme endepunkt i Node.js, Python og cURL

Spørsmål utviklere stiller før de ruller ut detaljbilder

Relatert funksjonalitet

Prøv API-et på fem minutter