Kyvykkyys · Yksityiskohtakuvat
Tuotteen yksityiskohtakuva-API lähikuville
Yhdellä lauseella
Phottan yksityiskohtakuva-API renderöi lähikuvan yhdestä tuotteen nimetystä alueesta. Ilmainen analyze-kutsu ehdottaa kuvaamisen arvoisia yksityiskohtia; generate-kutsu maksaa kiinteästi 3 credits ilman resoluutiotasoja.
- Tyypillinen kesto: 20–60 sec
- Credits: 3 credits
- Käsittely: asynkroninen, polling
- Rajoitukset: 600 pyyntöä/min
- Autentikointi: Bearer-avain
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
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"]Lyhyesti
Lyhyesti
- Endpoint
- POST /api/v1/detail-photos
- Autentikointi
- Bearer-API-avain
- Käsittely
- Asynkroninen — tee polling-kyselyitä status-endpointiin
- Tyypillinen kesto
- 20–60 sec
- Credits
- 3 credits
- Syöterajoitukset
- Enintään 10 MB per kuva; JPEG, PNG, WebP
- Idempotentti
- Ei
Pyyntö ja vastaus
Pyyntö
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"
}Pyyntöparametrit
product_imageTyyppi: stringPakollinen
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_labelTyyppi: stringPakollinen
The area to zoom into, e.g. "collar stitching", "cuff detail", "fabric weave on the chest", "pendant clasp". Max 100 characters.
detail_descriptionTyyppi: string
Extra guidance for the close-up. Max 400 characters.
framingTyyppi: 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
Arvot:extreme-closeupcloseupmedium-closeupsource_typeTyyppi: string
Tunes what is preserved in the close-up.
= apparel
Arvot:appareljewelry
Virheet
- 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.
Rajoitukset
- 600 pyyntöä minuutissa per API-avain (Kiinteä aikaikkuna; rajoitus on sama kaikissa tilauksissa)
- Vastaus 429 sisältää otsakkeen Retry-After: 30 sekuntia
- Enintään 10 MB per kuva
- Formaatit: JPEG, PNG, WebP
- Rinnakkaiset eräajot per tilaus: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Vain polling — API ei lähetä webhookeja.
Kysy, mikä kannattaa kuvata, ja kuvaa se sitten
Analysoi ilmaiseksi, valitse yksityiskohta, lähetä, pollaa, lataa.
Vaihe 1
Luo API-avain
Yksityiskohtakuvat käyttävät samoja tunnistetietoja ja samaa credit-saldoa kuin kaikki muutkin Phottan kyvykkyydet.
Vaihe 2
Kysy, mitkä yksityiskohdat kannattaa kuvata
Tee POST `/api/v1/detail-photos/analyze` parametrilla `product_image`. Se palauttaa synkronisesti ehdotetut `detail_label`-, `detail_description`- ja `framing`-arvot kyseiselle tuotteelle eikä veloita mitään.
Vaihe 3
Tee POST lähikuvalle
Tee POST osoitteeseen `/api/v1/detail-photos` parametreilla `product_image` ja `detail_label`. Aseta `framing`-arvoksi `extreme-closeup`, `closeup` tai `medium-closeup`, `source_type`-arvoksi `apparel` tai `jewelry`, ja lisää enintään 400 merkkiä kenttään `detail_description`.
Vaihe 4
Pollaa, kunnes työ valmistuu
Tee GET `/api/v1/detail-photos/:id` 3 sekunnin välein, kunnes `data.status` on `completed` tai `failed`; tyypillinen valmistumisaika on 20–60 sekuntia.
Vaihe 5
Lataa ja tallenna
Valmis vastausrunko sisältää arvon `output_url`. Yksityiskohtakuvat sopivat suoraan PDP-galleriaan pääkuvan viereen.
Sama endpoint kielillä Node.js, Python ja cURL
Node.js
Tuotteen yksityiskohtakuva-API ympäristössä Node.js
Kutsu Phottan ominaisuutta tuotteen yksityiskohtakuva-API Node.js-taustajärjestelmästä natiivilla fetchillä. SDK:ta ei tarvita: tallenna avaimesi, lähetä työ, pollaa tulosta.
LuePython
Tuotteen yksityiskohtakuva-API Pythonissa
Kutsu Phottan tuotteen yksityiskohtakuva-API -ominaisuutta Pythonissa requests-kirjaston avulla. Kolmenkymmenen rivin kääre, async-yhteensopiva httpx:n kautta, toimii Djangossa, FastAPIssa ja Celeryssä.
LuecURL
Tuotteen yksityiskohtakuva-API cURLillä
Kutsu Phottan tuotteen yksityiskohtakuva-API-rajapintaa suoraan komentoriviltä cURLin avulla. Lähetä, pollaa, lataa — jokainen koodinpätkä toimii yhdessä jq:n kanssa skriptatuissa putkissa.
Lue
Kysymyksiä, joita kehittäjät kysyvät ennen yksityiskohtakuvien julkaisua tuotantoon
Mikä on yksityiskohtakuva-API?
Endpoint, joka renderöi lähikuvan yhdestä tuotteen nimetystä alueesta — kauluksen tikkauksesta, lukosta, rinnan kudoksesta — yhdestä laajemmasta valokuvasta sen sijaan, että tarvittaisiin toinen studiosessio makro-objektiivilla.
Paljonko yksityiskohtakuva maksaa?
Kiinteät 3 credits. Tässä endpointissa ei ole resoluutiotasoja, ja yksityiskohtia ehdottava analyze-kutsu on ilmainen.
Mitä analyze-endpoint palauttaa?
Listan ehdotuksia, joista jokainen sisältää kentät `detail_label`, `detail_description` (joka selittää, miksi alue kannattaa näyttää) sekä suositellun `framing`-arvon. Voit syöttää minkä tahansa ehdotuksen suoraan generate-kutsuun.
Kuinka tiukka kukin rajausvaihtoehto on?
`extreme-closeup` täyttää lähes koko kuva-alan yksityiskohdalla, `closeup` jättää sen ympärille hieman kontekstia ja `medium-closeup` näyttää yksityiskohdan ympäröivässä vaatteessa tai tuotteessa. Valitse yksityiskohdan, älä tuotteen mukaan.
Voiko lähdekuva olla tekoälyllä luotu kuva?
Kyllä. `product_image` hyväksyy valmistuneen generoinnin `output_url`-arvon sekä minkä tahansa oman tuotekuvasi joko https-URL-osoitteena tai base64 data URI -muodossa.
Miten kyselen tulosta polling-menetelmällä?
Tee GET-kutsu osoitteeseen `/api/v1/detail-photos/:id` 3 sekunnin välein, kunnes `data.status` on `completed` tai `failed`. Analyze-kutsu on synkroninen eikä vaadi pollingia.
Liittyvät kyvykkyydet
Ominaisuudet
Virtuaalinen try-on API vaatteille
REST API, joka asettaa vaatteet tekoälymallinukkejen päälle. Asynkroninen, 1.5–4 minuutin generointi, 5 credits resoluutiolla 2K, 6 resoluutiolla 4K. cURL-, Node.js- ja Python-esimerkit.
Katso endpointOminaisuudet
Korujen try-on-API kaulakoruille, sormuksille, rannekoruille ja korvakoruille
Sovita kaulakoruja, sormuksia, rannekoruja ja korvakoruja AI-malleille RESTin kautta. 5 credits resoluutiolla 2K, sisäänrakennetut lähikuvamallit, heijastukset huomioiva renderöinti Photta-dokumentaation mukaisesti.
Katso endpointRakenna
Rakenna AI-tuotekuvauspalvelu
Perustajan opas Phottan virtuaalisen try-on API:n jälleenmyyntiin white-label-SaaS-palveluna: tenant-avaimet, eräajojen hajautus, credit-pohjainen laskutus ja todellinen SLA.
Katso endpointVertailu
Photta vs FASHN — Muodin AI-rajapinnat rinnakkain
Photta ja FASHN vertailussa: endpointit, credit-hinnoittelu, tilaustasot, samanaikaisuusrajat. Perustuu kummankin yrityksen omaan hinnoittelusivuun 2026-04-19. Ei keksittyjä lukuja.
Katso endpointPikaopas
Ensimmäinen Photta-kuva alle viidessä minuutissa.
Rekisteröidy, luo API-avain, suorita ensimmäinen cURL-kutsusi, tee pollingia valmistumiseen asti ja tallenna tulos. Viisi vaihetta, dokumentoitu alusta loppuun.
Katso endpointReferenssi
Photta API -virheet
Täydellinen luettelo Photta API -virhetyypeistä statuskoodeineen, virheen rungon rakenne ja tiedot siitä, mitkä virheet kannattaa yrittää uudelleen.
Katso endpointReferenssi
Photta API:n rate limitit
Photta API:n rate limit, sen aikaikkuna, Retry-After-otsake, pollausväli ja tilauskohtaiset rinnakkaisuusrajat, kaikki API-dokumentaatiosta luettuna.
Katso endpoint
Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu
Kokeile APIa viidessä minuutissa
Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.
- 20–60 sec
- 3 credits
- asynkroninen, polling
- 600 pyyntöä/min
- Bearer-avain