Avançar para o conteúdo

Pixelcut Product Photo

Integrar

ID do modelo 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Este pedido: 0,024 $ 24 créditos da API · ≈ 2,58 ₽ Executar nesta página

Obter chave de API
Pixelcut Edição de imagem #utility#editing

Compositor de imagens de produtos: recorta o artigo e coloca-o numa nova tela com fundo, margens e sombra

Pixelcut · Imagem

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório image_url
Largue um ficheiro ou

URL da imagem do produto a processar.

image_size predefinição square_hd

Dimensões do canvas de saída, especificadas como {width, height} personalizado ou como uma predefinição: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. A predefinição é square_hd (1024x1024).

Avançado output_format · background · margin · shadow · watermark
output_format

Codificação da imagem de saída, escolhida entre PNG ou JPEG, com JPEG indisponível para fundos transparentes. Se a seleção for omitida, o formato da entrada é preservado.

Fundo da saída: uma imagem, transparência ou uma cor sólida que, por predefinição, é branca.

Espaço entre o produto e as margens do canvas. Use `all` para definir todas as margens, com substituições opcionais para lados individuais; a predefinição é 20% por lado.

Configuração da sombra: selecione 'Generative' ou 'Drop' e configure as respetivas definições. Deixe por definir para não aplicar nenhuma sombra.

Sobreposição de logótipo ou marca de água ativada ao fornecer uma imagem; omiti-la deixa a saída sem marca de água, como acontece por predefinição.

POST /run/pixelcut/product-photo?wait=20 cotação → 0,024 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Pixelcut Product Photo

Processa uma fotografia de produto numa imagem com estilo de catálogo. Pode definir a tela com predefinições `image_size` ou dimensões personalizadas, escolher um `background` sólido, transparente ou de imagem e ajustar a `margin`. Estão disponíveis uma `shadow` generativa ou projetada e uma sobreposição opcional de `watermark`. O resultado é png ou jpeg, e jpeg não pode ser utilizado com um fundo transparente.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
URL da imagem do produto a processar.
image_sizeopcional
Tipoobject
Predefiniçãosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões do canvas de saída, especificadas como {width, height} personalizado ou como uma predefinição: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. A predefinição é square_hd (1024x1024).
backgroundopcional
Tipoobject
Fundo da saída: uma imagem, transparência ou uma cor sólida que, por predefinição, é branca.
background.modeopcional
Tipoenum
PredefiniçãoColor
TransparentColorImage
Modo de fundo: 'Color' usa `color`, com branco por predefinição; 'Transparent' produz transparência e usa sempre PNG; 'Image' compõe o resultado sobre `image_url`.
background.coloropcional
Tipoobject
Predefinição{"b":255,"g":255,"r":255}
Preenchimento de fundo sólido para o modo 'Color', branco por predefinição, especificado através de componentes R/G/B entre 0 e 255.
background.color.robrigatório
Tipointeger
0 – 255
background.color.gobrigatório
Tipointeger
0 – 255
background.color.bobrigatório
Tipointeger
0 – 255
background.image_urlopcional
Tipourl · image
URL da imagem de fundo; obrigatória no modo 'Image'.
background.image_fitopcional
Tipoenum
PredefiniçãoCover
CoverContainStretch
Escolha como ajustar a imagem de fundo ao canvas. 'Contain' preserva uma imagem ajustada com barras sobre `color`, enquanto 'Stretch' usa distorção para a ajustar; 'Cover' preenche o canvas recortando a imagem.
marginopcional
Tipoobject
Espaço entre o produto e as margens do canvas. Use `all` para definir todas as margens, com substituições opcionais para lados individuais; a predefinição é 20% por lado.
margin.allopcional
Tipostring
Predefinição20%
Margem uniforme em todos os lados, especificada como '%' da dimensão do canvas, de 0 a 49%, ou em 'px' com um mínimo de 0px.
margin.leftopcional
Tipostring | null
Margem esquerda que substitui `all` nesse lado. Aceita '%' de 0 a 49% ou 'px' a partir de 0px.
margin.rightopcional
Tipostring | null
Margem direita que substitui `all` nesse lado. Aceita '%' de 0 a 49% ou 'px' a partir de 0px.
margin.topopcional
Tipostring | null
Margem superior que substitui `all` nesse lado. Aceita '%' de 0 a 49% ou 'px' a partir de 0px.
margin.bottomopcional
Tipostring | null
Margem inferior que substitui `all` nesse lado. Aceita '%' de 0 a 49% ou 'px' a partir de 0px.
shadowopcional
Tipoobject
Configuração da sombra: selecione 'Generative' ou 'Drop' e configure as respetivas definições. Deixe por definir para não aplicar nenhuma sombra.
shadow.typeopcional
Tipoenum
GenerativeDrop
Estilo de sombra opcional, sem sombra quando não definido. Escolha 'Generative' para síntese por IA ou 'Drop' para uma sombra projetada determinística.
shadow.generativeopcional
Tipoobject
Definições da sombra gerada por IA, aplicadas quando o tipo é 'Generative'.
shadow.generative.opacityopcional
Tiponumber
Predefinição0.2
0 – 1
Opacidade da sombra totalmente composta, de 0 a 1.
shadow.generative.light_sourceopcional
Tipoobject
Fonte de luz virtual explícita para síntese da sombra, substituindo a estimativa automática da direção da luz a partir da imagem quando fornecida.
shadow.dropopcional
Tipoobject
Definições da sombra projetada, aplicadas quando o tipo é 'Drop'.
shadow.drop.coloropcional
Tipoobject
Predefinição{"b":0,"g":0,"r":0}
Cor RGB da sombra; preto é a predefinição.
shadow.drop.horizontalopcional
Tiponumber
Predefinição50
-100 – 100
Deslocamento horizontal da sombra, em que a definição máxima de 100 representa 10% da largura do canvas. Os valores variam de -100 a 100; valores negativos deslocam para a esquerda e positivos para a direita.
shadow.drop.verticalopcional
Tiponumber
Predefinição8
-100 – 100
Deslocamento vertical da sombra, em que a definição máxima de 100 representa 10% da altura do canvas. Os valores variam de -100 a 100; valores negativos deslocam para cima e positivos para baixo.
shadow.drop.bluropcional
Tiponumber
Predefinição24
0 – 100
Definição do desfoque da sombra, com a suavidade máxima em 100 correspondente a um raio de 5% da menor dimensão do canvas. O intervalo começa em 0, que mantém as margens nítidas.
shadow.drop.opacityopcional
Tiponumber
Predefinição0.25
0 – 1
Opacidade da sombra, de 0 a 1.
watermarkopcional
Tipoobject
Sobreposição de logótipo ou marca de água ativada ao fornecer uma imagem; omiti-la deixa a saída sem marca de água, como acontece por predefinição.
watermark.image_urlopcional
Tipourl · image
URL da imagem do logótipo ou da marca de água. Um valor vazio deixa a saída sem marca de água.
watermark.remove_backgroundopcional
Tipoboolean
Predefiniçãofalse
Indica se o fundo da marca de água deve ser removido para que a sobreposição não o inclua.
watermark.positionopcional
Tipoenum
Predefiniçãobottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Posicionamento da marca de água.
watermark.scaleopcional
Tiponumber
Predefinição0.1
0,01 – 1
Largura da marca de água, expressa como fração da largura do canvas.
watermark.opacityopcional
Tiponumber
Predefinição1
0 – 1
Opacidade da marca de água, de 0 a 1.
watermark.marginopcional
Tipostring
Predefinição3%
Distância para dentro a partir da margem do canvas, expressa como '%' do canvas (0–49%) ou em 'px'.
output_formatopcional
Tipoenum
pngjpeg
Codificação da imagem de saída, escolhida entre PNG ou JPEG, com JPEG indisponível para fundos transparentes. Se a seleção for omitida, o formato da entrada é preservado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
image
object {url, content_type, file_name, file_size, width, height} | nullFotografia de produto preparada para utilização em catálogo.

Mais modelos: Edição de imagem

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/pixelcut/product-photo.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt