Saltar al cuntegna

Pixelcut Product Photo

Integrar

ID dal model 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"

Questa dumonda: $0,024 24 credits API Lantschar sin questa pagina

Obtegna ina clav API
Pixelcut Modificaziun da maletgs #utility#editing

Compositor da fotografias da products: retira lʼobject e al plazza sin ina nova tela cun fund, margens e sumbriva

Pixelcut · Maletg

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori image_url
Trametta in datoteca u

URL dal maletg dal product per il processament.

image_size standard square_hd

Dimensiuns da la surfatscha da output, specifitgadas sco custom {width, height} u in preset: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Il standard è square_hd (1024x1024).

Avanzà output_format · background · margin · shadow · watermark
output_format

Codificaziun dal maletg d'output, tschernida tranter PNG u JPEG; JPEG n'è betg disponibel per fund transparents. Sche la selecziun vegn omessa, il format da l'input vegn mantegnì.

Funs per l'output: in maletg, transparenza u ina colur unifurma che è al standard alva.

Spazi tranter il product e las uras da la surfatscha. Utilisescha `all` per definir tut ils urs, cun surchargias facultativas per singuls urs; il standard è 20% per ura.

Configuraziun da l'ombra: tscherna 'Generative' u 'Drop' e configura sias settings. Lascha betg definì per na duvrar nagina ombra.

Overlay da logo u filigrana activà cun furnir in maletg; sch'el vegn omess, resta l'output senza filigrana, sco ch'el è per standard.

POST /run/pixelcut/product-photo?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Pixelcut Product Photo

Elavura ina foto da product en in maletg da la furma d'in catalog. Ti pos definir il canvas cun preselecziuns `image_size` u dimensiuns persunalizadas, tscherner in `background` solid, transparent u maletg, e adattar `margin`. Ina `shadow` generativa u drop e ina surposiziun `watermark` facultativa èn disponiblas. L'output è png u jpeg, e jpeg na po betg vegnir utilisà cun in sfond transparent.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL dal maletg dal product per il processament.
image_sizeopziunal
Tipobject
Standardsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensiuns da la surfatscha da output, specifitgadas sco custom {width, height} u in preset: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Il standard è square_hd (1024x1024).
backgroundopziunal
Tipobject
Funs per l'output: in maletg, transparenza u ina colur unifurma che è al standard alva.
background.modeopziunal
Tipenum
StandardColor
TransparentColorImage
Modus dal funs: 'Color' utilisescha `color`, cun alva sco standard; 'Transparent' producescha transparenza e utilisescha adina PNG; 'Image' cumbinescha il resultat sur `image_url`.
background.coloropziunal
Tipobject
Standard{"b":255,"g":255,"r":255}
Remplenida dal funs unifurm per il modus 'Color', alva sco standard, specifitgada tras cumponentas R/G/B tranter 0 e 255.
background.color.robligatori
Tipinteger
0 – 255
background.color.gobligatori
Tipinteger
0 – 255
background.color.bobligatori
Tipinteger
0 – 255
background.image_urlopziunal
Tipurl · image
URL dal maletg da funs; obligatoric en il modus 'Image'.
background.image_fitopziunal
Tipenum
StandardCover
CoverContainStretch
Tscherna co adattar il maletg da funs a la surfatscha. 'Contain' mantegna in maletg adattà cun barras sur `color`, entant che 'Stretch' utilisescha distorsiun per l'adattaziun; 'Cover' emplenescha la surfatscha cun retagliar.
marginopziunal
Tipobject
Spazi tranter il product e las uras da la surfatscha. Utilisescha `all` per definir tut ils urs, cun surchargias facultativas per singuls urs; il standard è 20% per ura.
margin.allopziunal
Tipstring
Standard20%
Margina uniforma da mintga vart, specifitgada sco '%' da la dimensiun da la surfatscha, da 0 fin 49%, u en 'px' cun in minimum da 0px.
margin.leftopziunal
Tipstring | null
Margina sanestra che remplazza `all` da quella vart. Accepta '%' da 0 fin 49% u 'px' a partir da 0px.
margin.rightopziunal
Tipstring | null
Margina dretga che remplazza `all` da quella vart. Accepta '%' da 0 fin 49% u 'px' a partir da 0px.
margin.topopziunal
Tipstring | null
Margina sura che remplazza `all` da quella vart. Accepta '%' da 0 fin 49% u 'px' a partir da 0px.
margin.bottomopziunal
Tipstring | null
Margina sut che remplazza `all` da quella vart. Accepta '%' da 0 fin 49% u 'px' a partir da 0px.
shadowopziunal
Tipobject
Configuraziun da l'ombra: tscherna 'Generative' u 'Drop' e configura sias settings. Lascha betg definì per na duvrar nagina ombra.
shadow.typeopziunal
Tipenum
GenerativeDrop
Stil d'ombra facultativ, senza ombra sch'el n'è betg definì. Tscherna 'Generative' per ina sintesa tras l'AI u 'Drop' per ina ombra deterministica.
shadow.generativeopziunal
Tipobject
Settings per l'ombra generada da l'AI, applitgads sche il tip è 'Generative'.
shadow.generative.opacityopziunal
Tipnumber
Standard0.2
0 – 1
Opacitad da l'ombra cumplettamain cumposita, da 0 fin 1.
shadow.generative.light_sourceopziunal
Tipobject
Funtauna virtuala da glisch explicita per la sintesa da l'ombra, che remplazza l'estimaziun automatica da la direcziun da la glisch dal maletg sch'ella vegn furnida.
shadow.dropopziunal
Tipobject
Settings per l'ombra projectada, applitgads sche il tip è 'Drop'.
shadow.drop.coloropziunal
Tipobject
Standard{"b":0,"g":0,"r":0}
Colur RGB per l'ombra; nair è il standard.
shadow.drop.horizontalopziunal
Tipnumber
Standard50
-100 – 100
Sviament orizontal da l'ombra, nua che la configuraziun maximala da 100 represchenta 10% da la ladezza da la surfatscha. Las valurs tanschan da -100 fin 100; valurs negativas spostan a sanestra e positivas a dretga.
shadow.drop.verticalopziunal
Tipnumber
Standard8
-100 – 100
Sviament vertical da l'ombra, nua che la configuraziun maximala da 100 represchenta 10% da l'autezza da la surfatscha. Las valurs tanschan da -100 fin 100; valurs negativas spostan ensi e positivas engiu.
shadow.drop.bluropziunal
Tipnumber
Standard24
0 – 100
Configuraziun dal blur da l'ombra, cun la morbiditad maximala a 100 correspundenta ad in radius da 5% da la pli curta dimensiun da la surfatscha. La gruppa cumenza tar 0, che lascha las uras diras.
shadow.drop.opacityopziunal
Tipnumber
Standard0.25
0 – 1
Opacitad da l'ombra, da 0 fin 1.
watermarkopziunal
Tipobject
Overlay da logo u filigrana activà cun furnir in maletg; sch'el vegn omess, resta l'output senza filigrana, sco ch'el è per standard.
watermark.image_urlopziunal
Tipurl · image
URL dal maletg dal logo u da la filigrana. Ina valur vida lascha l'output senza filigrana.
watermark.remove_backgroundopziunal
Tipboolean
Standardfalse
Inditgescha sch'il funs da la filigrana duai vegnir allontanà cun allontanar il funs, uschia che l'overlay na cuntegna betg quel.
watermark.positionopziunal
Tipenum
Standardbottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Posiziun da la filigrana.
watermark.scaleopziunal
Tipnumber
Standard0.1
0,01 – 1
Ladezza da la filigrana, exprimida sco fracziun da la ladezza da la surfatscha.
watermark.opacityopziunal
Tipnumber
Standard1
0 – 1
Opacitad da la filigrana, da 0 fin 1.
watermark.marginopziunal
Tipstring
Standard3%
Distanza vers l'intern da l'ura da la surfatscha, exprimida sco '%' da la surfatscha (0–49%) u en 'px'.
output_formatopziunal
Tipenum
pngjpeg
Codificaziun dal maletg d'output, tschernida tranter PNG u JPEG; JPEG n'è betg disponibel per fund transparents. Sche la selecziun vegn omessa, il format da l'input vegn mantegnì.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
image
object {url, content_type, file_name, file_size, width, height} | nullFotografia da product preparada per l'utilisaziun en catalog.

Dapli models: Modificaziun da maletgs

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/pixelcut/product-photo.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt