Vai al contenuto

Pixelcut Product Photo

Integra

ID del modello 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 richiesta: 0,024 $ 24 crediti API Esegui in questa pagina

Ottieni la chiave API
Pixelcut Modifica immagini #utility#editing

Compositore di immagini di prodotto: ritaglia l'articolo e lo posiziona su una nuova tela con sfondo, margini e ombra

Pixelcut · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio image_url
Trascina un file oppure

URL dell'immagine del prodotto da elaborare.

image_size predefinito square_hd

Dimensioni della tela di output, specificate come {width, height} personalizzati o come preset: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Il valore predefinito è square_hd (1024x1024).

Avanzate output_format · background · margin · shadow · watermark
output_format

Codifica dell'immagine di output, scelta tra PNG o JPEG; JPEG non è disponibile per sfondi trasparenti. Omettendo la selezione, viene mantenuto il formato dell'input.

Sfondo dell'output: un'immagine, trasparenza o un colore uniforme predefinito al bianco.

Spazio tra il prodotto e i bordi della tela. Usa `all` per impostare tutti i margini, con override opzionali per i singoli lati; il valore predefinito è 20% per lato.

Configurazione dell'ombra: seleziona 'Generative' o 'Drop' e configura le relative impostazioni. Lascia non impostato per non applicare alcuna ombra.

Sovrapposizione di logo o filigrana abilitata fornendo un'immagine; omettendola l'output rimane senza filigrana, come da impostazione predefinita.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Pixelcut Product Photo

Elabora una foto di prodotto in stile catalogo. Puoi impostare la tela con i preset di `image_size` o dimensioni personalizzate, scegliere uno `background` a tinta unita, trasparente o basato su un'immagine e regolare `margin`. Sono disponibili un'ombra `shadow` generativa o proiettata e una sovrapposizione `watermark` opzionale. L'output è png o jpeg; jpeg non può essere usato con uno sfondo trasparente.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL dell'immagine del prodotto da elaborare.
image_sizefacoltativo
Tipoobject
Predefinitosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni della tela di output, specificate come {width, height} personalizzati o come preset: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Il valore predefinito è square_hd (1024x1024).
backgroundfacoltativo
Tipoobject
Sfondo dell'output: un'immagine, trasparenza o un colore uniforme predefinito al bianco.
background.modefacoltativo
Tipoenum
PredefinitoColor
TransparentColorImage
Modalità dello sfondo: 'Color' usa `color`, con valore predefinito bianco; 'Transparent' produce trasparenza e usa sempre PNG; 'Image' sovrappone il risultato a `image_url`.
background.colorfacoltativo
Tipoobject
Predefinito{"b":255,"g":255,"r":255}
Riempimento dello sfondo uniforme per la modalità 'Color', bianco per impostazione predefinita, specificato tramite componenti R/G/B da 0 a 255.
background.color.robbligatorio
Tipointeger
0 – 255
background.color.gobbligatorio
Tipointeger
0 – 255
background.color.bobbligatorio
Tipointeger
0 – 255
background.image_urlfacoltativo
Tipourl · image
URL dell'immagine di sfondo; obbligatorio nella modalità 'Image'.
background.image_fitfacoltativo
Tipoenum
PredefinitoCover
CoverContainStretch
Scegli come adattare l'immagine di sfondo alla tela. 'Contain' preserva un'immagine adattata con bande su `color`, mentre 'Stretch' usa la distorsione per adattarla; 'Cover' riempie la tela ritagliando l'immagine.
marginfacoltativo
Tipoobject
Spazio tra il prodotto e i bordi della tela. Usa `all` per impostare tutti i margini, con override opzionali per i singoli lati; il valore predefinito è 20% per lato.
margin.allfacoltativo
Tipostring
Predefinito20%
Margine uniforme su ogni lato, specificato come '%' della dimensione della tela, da 0 a 49%, oppure in 'px' con un minimo di 0px.
margin.leftfacoltativo
Tipostring | null
Margine sinistro che sostituisce `all` su quel lato. Accetta '%' da 0 a 49% oppure 'px' da 0px in su.
margin.rightfacoltativo
Tipostring | null
Margine destro che sostituisce `all` su quel lato. Accetta '%' da 0 a 49% oppure 'px' da 0px in su.
margin.topfacoltativo
Tipostring | null
Margine superiore che sostituisce `all` su quel lato. Accetta '%' da 0 a 49% oppure 'px' da 0px in su.
margin.bottomfacoltativo
Tipostring | null
Margine inferiore che sostituisce `all` su quel lato. Accetta '%' da 0 a 49% oppure 'px' da 0px in su.
shadowfacoltativo
Tipoobject
Configurazione dell'ombra: seleziona 'Generative' o 'Drop' e configura le relative impostazioni. Lascia non impostato per non applicare alcuna ombra.
shadow.typefacoltativo
Tipoenum
GenerativeDrop
Stile opzionale dell'ombra, senza ombra se non impostato. Scegli 'Generative' per la sintesi AI o 'Drop' per un'ombra proiettata deterministica.
shadow.generativefacoltativo
Tipoobject
Impostazioni dell'ombra generata dall'AI, applicate quando il tipo è 'Generative'.
shadow.generative.opacityfacoltativo
Tiponumber
Predefinito0.2
0 – 1
Opacità dell'ombra completamente composta, da 0 a 1.
shadow.generative.light_sourcefacoltativo
Tipoobject
Sorgente di luce virtuale esplicita per la sintesi dell'ombra, che sostituisce la stima automatica della direzione della luce dall'immagine quando fornita.
shadow.dropfacoltativo
Tipoobject
Impostazioni dell'ombra proiettata, applicate quando il tipo è 'Drop'.
shadow.drop.colorfacoltativo
Tipoobject
Predefinito{"b":0,"g":0,"r":0}
Colore RGB dell'ombra; il valore predefinito è nero.
shadow.drop.horizontalfacoltativo
Tiponumber
Predefinito50
-100 – 100
Spostamento orizzontale dell'ombra, dove l'impostazione massima di 100 rappresenta il 10% della larghezza della tela. I valori vanno da -100 a 100: quelli negativi spostano a sinistra e quelli positivi a destra.
shadow.drop.verticalfacoltativo
Tiponumber
Predefinito8
-100 – 100
Spostamento verticale dell'ombra, dove l'impostazione massima di 100 rappresenta il 10% dell'altezza della tela. I valori vanno da -100 a 100: quelli negativi spostano verso l'alto e quelli positivi verso il basso.
shadow.drop.blurfacoltativo
Tiponumber
Predefinito24
0 – 100
Impostazione della sfocatura dell'ombra, con morbidezza massima a 100 corrispondente a un raggio pari al 5% della dimensione minore della tela. L'intervallo parte da 0, che mantiene i bordi netti.
shadow.drop.opacityfacoltativo
Tiponumber
Predefinito0.25
0 – 1
Opacità dell'ombra, da 0 a 1.
watermarkfacoltativo
Tipoobject
Sovrapposizione di logo o filigrana abilitata fornendo un'immagine; omettendola l'output rimane senza filigrana, come da impostazione predefinita.
watermark.image_urlfacoltativo
Tipourl · image
URL dell'immagine del logo o della filigrana. Un valore vuoto lascia l'output senza filigrana.
watermark.remove_backgroundfacoltativo
Tipoboolean
Predefinitofalse
Indica se rimuovere lo sfondo della filigrana tramite la rimozione dello sfondo, in modo che la sovrapposizione lo escluda.
watermark.positionfacoltativo
Tipoenum
Predefinitobottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Posizione della filigrana.
watermark.scalefacoltativo
Tiponumber
Predefinito0.1
0,01 – 1
Larghezza della filigrana, espressa come frazione della larghezza della tela.
watermark.opacityfacoltativo
Tiponumber
Predefinito1
0 – 1
Opacità della filigrana, da 0 a 1.
watermark.marginfacoltativo
Tipostring
Predefinito3%
Distanza verso l'interno dal bordo della tela, espressa come '%' della tela (0–49%) o in 'px'.
output_formatfacoltativo
Tipoenum
pngjpeg
Codifica dell'immagine di output, scelta tra PNG o JPEG; JPEG non è disponibile per sfondi trasparenti. Omettendo la selezione, viene mantenuto il formato dell'input.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
image
object {url, content_type, file_name, file_size, width, height} | nullFotografia del prodotto preparata per l'uso in catalogo.

Altri modelli: Modifica immagini

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/pixelcut/product-photo.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt