Passer au contenu

Pixelcut Product Photo

Intégrer

Identifiant du modèle 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"

Cette requête: 0,024 $ 24 crédits API L’exécuter sur cette page

Obtenir une clé API
Pixelcut Édition d’image #utility#editing

Composeur d’images de produits : détoure l’article et le place sur une nouvelle toile avec arrière-plan, marges et ombre

Pixelcut · image

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis image_url
Déposez un fichier, ou

URL de l’image du produit à traiter.

image_size par défaut square_hd

Dimensions de la zone de sortie, spécifiées comme {width, height} personnalisé ou selon un préréglage : square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. La valeur par défaut est square_hd (1024x1024).

Avancé output_format · background · margin · shadow · watermark
output_format

Encodage de l’image de sortie, choisi entre PNG et JPEG, JPEG étant indisponible pour les arrière-plans transparents. Omettre cette sélection conserve le format de l’entrée.

Arrière-plan de la sortie : une image, de la transparence ou une couleur unie blanche par défaut.

Espace entre le produit et les bords de la zone de sortie. Utilisez `all` pour définir toutes les marges, avec des remplacements facultatifs pour chaque côté ; la valeur par défaut est de 20% par côté.

Configuration de l’ombre : sélectionnez 'Generative' ou 'Drop' et configurez ses paramètres. Laissez ce champ vide pour n’appliquer aucune ombre.

Superposition de logo ou de filigrane activée en fournissant une image ; son omission laisse la sortie sans filigrane, comme par défaut.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Pixelcut Product Photo

Transforme une photo de produit en image de style catalogue. Vous pouvez définir la toile avec les préréglages de `image_size` ou des dimensions personnalisées, choisir un `background` uni, transparent ou basé sur une image, et régler la `margin`. Une `shadow` générative ou portée ainsi qu’un calque `watermark` facultatif sont disponibles. La sortie est au format png ou jpeg, et jpeg ne peut pas être utilisé avec un arrière-plan transparent.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
URL de l’image du produit à traiter.
image_sizefacultatif
Typeobject
Par défautsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de la zone de sortie, spécifiées comme {width, height} personnalisé ou selon un préréglage : square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. La valeur par défaut est square_hd (1024x1024).
backgroundfacultatif
Typeobject
Arrière-plan de la sortie : une image, de la transparence ou une couleur unie blanche par défaut.
background.modefacultatif
Typeenum
Par défautColor
TransparentColorImage
Mode d’arrière-plan : 'Color' utilise `color`, avec le blanc par défaut ; 'Transparent' produit de la transparence et utilise toujours PNG ; 'Image' compose le résultat sur `image_url`.
background.colorfacultatif
Typeobject
Par défaut{"b":255,"g":255,"r":255}
Remplissage d’arrière-plan uni pour le mode 'Color', blanc par défaut, spécifié par des composantes R/G/B comprises entre 0 et 255.
background.color.rrequis
Typeinteger
0 – 255
background.color.grequis
Typeinteger
0 – 255
background.color.brequis
Typeinteger
0 – 255
background.image_urlfacultatif
Typeurl · image
URL de l’image d’arrière-plan ; obligatoire en mode 'Image'.
background.image_fitfacultatif
Typeenum
Par défautCover
CoverContainStretch
Choisissez comment adapter l’image d’arrière-plan à la zone de sortie. 'Contain' conserve une image ajustée avec des bandes sur `color`, tandis que 'Stretch' utilise une distorsion pour l’ajuster ; 'Cover' remplit la zone en recadrant.
marginfacultatif
Typeobject
Espace entre le produit et les bords de la zone de sortie. Utilisez `all` pour définir toutes les marges, avec des remplacements facultatifs pour chaque côté ; la valeur par défaut est de 20% par côté.
margin.allfacultatif
Typestring
Par défaut20%
Marge uniforme sur chaque côté, spécifiée en '%' de la dimension de la zone de sortie, de 0 à 49%, ou en 'px' avec un minimum de 0px.
margin.leftfacultatif
Typestring | null
Marge gauche remplaçant `all` de ce côté. Accepte '%' de 0 à 49%, ou 'px' à partir de 0px.
margin.rightfacultatif
Typestring | null
Marge droite remplaçant `all` de ce côté. Accepte '%' de 0 à 49%, ou 'px' à partir de 0px.
margin.topfacultatif
Typestring | null
Marge supérieure remplaçant `all` de ce côté. Accepte '%' de 0 à 49%, ou 'px' à partir de 0px.
margin.bottomfacultatif
Typestring | null
Marge inférieure remplaçant `all` de ce côté. Accepte '%' de 0 à 49%, ou 'px' à partir de 0px.
shadowfacultatif
Typeobject
Configuration de l’ombre : sélectionnez 'Generative' ou 'Drop' et configurez ses paramètres. Laissez ce champ vide pour n’appliquer aucune ombre.
shadow.typefacultatif
Typeenum
GenerativeDrop
Style d’ombre facultatif, sans ombre lorsqu’il est vide. Choisissez 'Generative' pour une synthèse par IA ou 'Drop' pour une ombre portée déterministe.
shadow.generativefacultatif
Typeobject
Paramètres de l’ombre générée par l’IA, appliqués lorsque le type est 'Generative'.
shadow.generative.opacityfacultatif
Typenumber
Par défaut0.2
0 – 1
Opacité de l’ombre entièrement composée, de 0 à 1.
shadow.generative.light_sourcefacultatif
Typeobject
Source de lumière virtuelle explicite pour la synthèse de l’ombre, remplaçant l’estimation automatique de la direction de la lumière à partir de l’image lorsqu’elle est fournie.
shadow.dropfacultatif
Typeobject
Paramètres de l’ombre portée, appliqués lorsque le type est 'Drop'.
shadow.drop.colorfacultatif
Typeobject
Par défaut{"b":0,"g":0,"r":0}
Couleur RVB de l’ombre ; le noir est la valeur par défaut.
shadow.drop.horizontalfacultatif
Typenumber
Par défaut50
-100 – 100
Déplacement horizontal de l’ombre, où le réglage maximal de 100 représente 10% de la largeur de la zone de sortie. Les valeurs vont de -100 à 100 ; les valeurs négatives décalent vers la gauche et les positives vers la droite.
shadow.drop.verticalfacultatif
Typenumber
Par défaut8
-100 – 100
Déplacement vertical de l’ombre, où le réglage maximal de 100 représente 10% de la hauteur de la zone de sortie. Les valeurs vont de -100 à 100 ; les valeurs négatives décalent vers le haut et les positives vers le bas.
shadow.drop.blurfacultatif
Typenumber
Par défaut24
0 – 100
Réglage du flou de l’ombre, avec une douceur maximale à 100 correspondant à un rayon de 5% de la plus petite dimension de la zone de sortie. La plage commence à 0, ce qui conserve des bords nets.
shadow.drop.opacityfacultatif
Typenumber
Par défaut0.25
0 – 1
Opacité de l’ombre, de 0 à 1.
watermarkfacultatif
Typeobject
Superposition de logo ou de filigrane activée en fournissant une image ; son omission laisse la sortie sans filigrane, comme par défaut.
watermark.image_urlfacultatif
Typeurl · image
URL de l’image du logo ou du filigrane. Une valeur vide laisse la sortie sans filigrane.
watermark.remove_backgroundfacultatif
Typeboolean
Par défautfalse
Indique s’il faut supprimer l’arrière-plan du filigrane à l’aide de la suppression d’arrière-plan afin que la superposition l’exclue.
watermark.positionfacultatif
Typeenum
Par défautbottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Positionnement du filigrane.
watermark.scalefacultatif
Typenumber
Par défaut0.1
0,01 – 1
Largeur du filigrane, exprimée comme une fraction de la largeur de la zone de sortie.
watermark.opacityfacultatif
Typenumber
Par défaut1
0 – 1
Opacité du filigrane, de 0 à 1.
watermark.marginfacultatif
Typestring
Par défaut3%
Distance vers l’intérieur depuis le bord de la zone de sortie, exprimée en '%' de la zone de sortie (0–49%) ou en 'px'.
output_formatfacultatif
Typeenum
pngjpeg
Encodage de l’image de sortie, choisi entre PNG et JPEG, JPEG étant indisponible pour les arrière-plans transparents. Omettre cette sélection conserve le format de l’entrée.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
image
object {url, content_type, file_name, file_size, width, height} | nullPhotographie de produit préparée pour un catalogue.

Plus de modèles : Édition d’image

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/pixelcut/product-photo.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt