Siirry sisältöön

Pixelcut Product Photo

Integroi

Mallin tunniste pixelcut/product-photo
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Tämä pyyntö: 0,024 $ 24 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Pixelcut Kuvan muokkaus #utility#editing

Tuotekuvakompositori: irrottaa kohteen ja sijoittaa sen uudelle taustalla, reunuksilla ja varjolla varustetulle kankaalle

Pixelcut · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen image_url
Pudota tiedosto tai

Käsiteltävän tuotekuvan URL-osoite.

image_size oletus square_hd

Tulostekankaan mitat muodossa mukautettu {width, height} tai esiasetus: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Oletus on square_hd (1024x1024).

Lisäasetukset output_format · background · margin · shadow · watermark
output_format

Tulostekuvan koodaus, valittavissa PNG tai JPEG; JPEG ei ole käytettävissä läpinäkyvällä taustalla. Valinnan pois jättäminen säilyttää syötteen muodon.

Tulosteen tausta: kuva, läpinäkyvyys tai yksivärinen tausta, jonka oletusväri on valkoinen.

Tuotteen ja kankaan reunojen välinen tila. Aseta kaikki marginaalit käyttämällä `all`-arvoa ja ohita tarvittaessa yksittäisiä reunoja; oletus on 20 % kullakin sivulla.

Varjon määritys: valitse 'Generative' tai 'Drop' ja määritä sen asetukset. Jätä arvo asettamatta, jos varjoa ei käytetä.

Logon tai vesileiman peitekuva otetaan käyttöön toimittamalla kuva; jos se jätetään pois, tulosteeseen ei lisätä vesileimaa, kuten oletuksena.

POST /run/pixelcut/product-photo?wait=20 hinta → 0,024 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixelcut/product-photo?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Pixelcut Product Photo

Käsittelee tuotekuvan katalogityyliseksi kuvaksi. Kankaan voi määrittää `image_size`-esiasetuksilla tai mukautetuilla mitoilla, ja `background` voi olla yksivärinen, läpinäkyvä tai kuva. `margin`-arvoa voi säätää. Saatavilla ovat generatiivinen tai pudotus-`shadow` sekä valinnainen `watermark`-peite. Tuloste on png tai jpeg, eikä jpeg-kuvaa voi käyttää läpinäkyvän taustan kanssa.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
Käsiteltävän tuotekuvan URL-osoite.
image_sizevalinnainen
Tyyppiobject
Oletussquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Tulostekankaan mitat muodossa mukautettu {width, height} tai esiasetus: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Oletus on square_hd (1024x1024).
backgroundvalinnainen
Tyyppiobject
Tulosteen tausta: kuva, läpinäkyvyys tai yksivärinen tausta, jonka oletusväri on valkoinen.
background.modevalinnainen
Tyyppienum
OletusColor
TransparentColorImage
Taustatila: 'Color' käyttää `color`-arvoa, jonka oletus on valkoinen; 'Transparent' tuottaa läpinäkyvän taustan ja käyttää aina PNG-muotoa; 'Image' yhdistää tuloksen `image_url`-kuvan päälle.
background.colorvalinnainen
Tyyppiobject
Oletus{"b":255,"g":255,"r":255}
Yksivärinen taustatäyttö 'Color'-tilaa varten, oletuksena valkoinen; määritetään R/G/B-komponenteilla välillä 0–255.
background.color.rpakollinen
Tyyppiinteger
0 – 255
background.color.gpakollinen
Tyyppiinteger
0 – 255
background.color.bpakollinen
Tyyppiinteger
0 – 255
background.image_urlvalinnainen
Tyyppiurl · image
Taustakuvan URL-osoite; pakollinen 'Image'-tilassa.
background.image_fitvalinnainen
Tyyppienum
OletusCover
CoverContainStretch
Valitse, miten taustakuva sovitetaan kankaalle. 'Contain' säilyttää sovitetun kuvan ja lisää letterbox-alueet `color`-värillä, kun taas 'Stretch' vääristää kuvaa sovittaakseen sen; 'Cover' täyttää kankaan rajaamalla kuvaa.
marginvalinnainen
Tyyppiobject
Tuotteen ja kankaan reunojen välinen tila. Aseta kaikki marginaalit käyttämällä `all`-arvoa ja ohita tarvittaessa yksittäisiä reunoja; oletus on 20 % kullakin sivulla.
margin.allvalinnainen
Tyyppistring
Oletus20%
Yhtenäinen marginaali kaikilla sivuilla, määritettynä kankaan mitan prosenttiosuutena välillä 0–49 % tai 'px'-yksikköinä vähintään 0px:n arvolla.
margin.leftvalinnainen
Tyyppistring | null
Vasemman reunan marginaali, joka korvaa `all`-arvon kyseisellä sivulla. Hyväksyy '%' arvot välillä 0–49 % tai 'px'-arvot vähintään 0px:stä alkaen.
margin.rightvalinnainen
Tyyppistring | null
Oikean reunan marginaali, joka korvaa `all`-arvon kyseisellä sivulla. Hyväksyy '%' arvot välillä 0–49 % tai 'px'-arvot vähintään 0px:stä alkaen.
margin.topvalinnainen
Tyyppistring | null
Yläreunan marginaali, joka korvaa `all`-arvon kyseisellä sivulla. Hyväksyy '%' arvot välillä 0–49 % tai 'px'-arvot vähintään 0px:stä alkaen.
margin.bottomvalinnainen
Tyyppistring | null
Alareunan marginaali, joka korvaa `all`-arvon kyseisellä sivulla. Hyväksyy '%' arvot välillä 0–49 % tai 'px'-arvot vähintään 0px:stä alkaen.
shadowvalinnainen
Tyyppiobject
Varjon määritys: valitse 'Generative' tai 'Drop' ja määritä sen asetukset. Jätä arvo asettamatta, jos varjoa ei käytetä.
shadow.typevalinnainen
Tyyppienum
GenerativeDrop
Valinnainen varjon tyyli; jos arvoa ei aseteta, varjoa ei käytetä. Valitse 'Generative' tekoälysynteesiä tai 'Drop' determinististä varjoa varten.
shadow.generativevalinnainen
Tyyppiobject
Tekoälyn generoiman varjon asetukset, joita käytetään, kun tyypiksi on valittu 'Generative'.
shadow.generative.opacityvalinnainen
Tyyppinumber
Oletus0.2
0 – 1
Kokonaan yhdistetyn varjon peittävyys välillä 0–1.
shadow.generative.light_sourcevalinnainen
Tyyppiobject
Varjon synteesiä varten määritetty virtuaalinen valonlähde, joka korvaa kuvan valosuunnan automaattisen arvion, jos se toimitetaan.
shadow.dropvalinnainen
Tyyppiobject
Pudotusvarjon asetukset, joita käytetään, kun tyypiksi on valittu 'Drop'.
shadow.drop.colorvalinnainen
Tyyppiobject
Oletus{"b":0,"g":0,"r":0}
Varjon RGB-väri; oletus on musta.
shadow.drop.horizontalvalinnainen
Tyyppinumber
Oletus50
−100 – 100
Varjon vaakasuuntainen siirtymä, jossa enimmäisasetus 100 vastaa 10 %:a kankaan leveydestä. Arvot ovat välillä -100–100: negatiiviset arvot siirtävät vasemmalle ja positiiviset oikealle.
shadow.drop.verticalvalinnainen
Tyyppinumber
Oletus8
−100 – 100
Varjon pystysuuntainen siirtymä, jossa enimmäisasetus 100 vastaa 10 %:a kankaan korkeudesta. Arvot ovat välillä -100–100: negatiiviset arvot siirtävät ylöspäin ja positiiviset alaspäin.
shadow.drop.blurvalinnainen
Tyyppinumber
Oletus24
0 – 100
Varjon sumennusasetus, jossa enimmäispehmeys 100 vastaa sädettä, joka on 5 % kankaan lyhyemmästä mitasta. Arvoalue alkaa 0:sta, jolloin reunat jäävät teräviksi.
shadow.drop.opacityvalinnainen
Tyyppinumber
Oletus0.25
0 – 1
Varjon peittävyys välillä 0–1.
watermarkvalinnainen
Tyyppiobject
Logon tai vesileiman peitekuva otetaan käyttöön toimittamalla kuva; jos se jätetään pois, tulosteeseen ei lisätä vesileimaa, kuten oletuksena.
watermark.image_urlvalinnainen
Tyyppiurl · image
Logon tai vesileimakuvan URL-osoite. Tyhjä arvo jättää tulosteen ilman vesileimaa.
watermark.remove_backgroundvalinnainen
Tyyppiboolean
Oletusfalse
Poistetaanko vesileiman tausta taustanpoistolla, jolloin peite ei sisällä sitä.
watermark.positionvalinnainen
Tyyppienum
Oletusbottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Vesileiman sijoittelu.
watermark.scalevalinnainen
Tyyppinumber
Oletus0.1
0,01 – 1
Vesileiman leveys kankaan leveyden murto-osana.
watermark.opacityvalinnainen
Tyyppinumber
Oletus1
0 – 1
Vesileiman peittävyys välillä 0–1.
watermark.marginvalinnainen
Tyyppistring
Oletus3%
Etäisyys kankaan reunasta sisäänpäin, kankaan prosenttiosuutena 0–49 % tai 'px'-yksikköinä.
output_formatvalinnainen
Tyyppienum
pngjpeg
Tulostekuvan koodaus, valittavissa PNG tai JPEG; JPEG ei ole käytettävissä läpinäkyvällä taustalla. Valinnan pois jättäminen säilyttää syötteen muodon.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixelcut/product-photo",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 24,
    "usd": "0.024",
    "charged": 24,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
image
object {url, content_type, file_name, file_size, width, height} | nullLuetteloa varten valmisteltu tuotekuva.

Lisää malleja: Kuvan muokkaus

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/pixelcut/product-photo.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt