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
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"]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')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"
}Request-parametrar
product_imageTyp: 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_labelTyp: stringObligatorisk
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_descriptionTyp: string
Extra guidance for the close-up. Max 400 characters.
framingTyp: 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-closeupsource_typeTyp: string
Tunes what is preserved in the close-up.
= apparel
Värden:appareljewelry
Fel
- 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.
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.
Steg 1
Generera en API-nyckel
Detaljfoton använder samma inloggningsuppgifter och samma credit-saldo som alla andra förmågor i Photta.
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.
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`.
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.
Steg 5
Ladda ner och spara
Det färdiga svaret innehåller `output_url`. Detaljfoton passar direkt in i ett PDP-galleri bredvid huvudbilden.
Samma endpoint i Node.js, Python och cURL
Node.js
API för produktdetaljbilder i Node.js
Anropa Phottas aPI för produktdetaljbilder från en Node.js-backend med inbyggd fetch. Ingen SDK krävs: lagra din nyckel, skicka in jobbet, polla efter resultatet.
LäsPython
API för produktdetaljbilder i Python
Anropa Phottas aPI för produktdetaljbilder i Python med requests-biblioteket. Wrapper på trettio rader, async-vänlig via httpx, fungerar i Django, FastAPI och Celery.
LäscURL
API för produktdetaljbilder med cURL
Anropa Phottas aPI för produktdetaljbilder direkt från skalet med cURL. Skicka, polla, ladda ner — alla kodavsnitt fungerar tillsammans med jq för skriptade pipelines.
Läs
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
Funktioner
API för virtuell try-on för apparel
REST API som placerar kläder på AI-mannekänger. Asynkron, 1,5–4 minuters generering, 5 credits vid 2K, 6 vid 4K. Exempel för cURL, Node.js och Python.
Se endpointFunktioner
API för smyckes-try-on för halsband, ringar, armband och örhängen
Placera halsband, ringar, armband och örhängen på AI-modeller via REST. 5 credits vid 2K, inbyggda närbildsprovdockor, reflexmedveten rendering från Photta-dokumentationen.
Se endpointBygg
Bygg en tjänst för AI-produktfotografering
En grundares playbook för att återförsälja Phottas virtuella try-on-API som en white-label-SaaS: klientnycklar, batch-fanout, fakturering per credit, SLA-realiteter.
Se endpointJämför
Photta mot FASHN — AI-mode-API, sida vid sida
Photta och FASHN jämförda: endpoints, kreditpriser, plannivåer, gränser för samtidighet. Hämtat från respektive företags egen prissida 2026-04-19. Inga påhittade siffror.
Se endpointSnabbstart
Första Photta-bilden på under fem minuter.
Skapa konto, generera en API-nyckel, kör ditt första cURL-anrop, polla tills det är klart, spara resultatet. Fem steg, dokumenterade från början till slut.
Se endpointReferens
Photta API-fel
Den fullständiga listan över feltyper i Photta API med deras statuskoder, strukturen på ett felmeddelande, och vilka fel som är värda att försöka igen.
Se endpointReferens
Photta API rate limits
Photta API:s rate limit, dess fönster, Retry-After-headern, polling-intervallet och taken för samtidighet per abonnemang, allt hämtat från API-dokumentationen.
Se endpoint
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