Ir 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"

Esta solicitação: $ 0,024 24 créditos de 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 item e o coloca em uma nova tela com fundo, margens e sombra

Pixelcut · Imagem

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório image_url
Solte um arquivo ou

URL da imagem do produto para processamento.

image_size padrão square_hd

Dimensões da tela de saída, especificadas como {width, height} personalizado ou uma predefinição: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. O padrã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. Omitir a seleção preserva o formato da entrada.

Plano de fundo da saída: uma imagem, transparência ou uma cor sólida que usa branco por padrão.

Espaço entre o produto e as bordas da tela. Use `all` para definir todas as margens, com substituições opcionais para lados individuais; o padrão é 20% por lado.

Configuração da sombra: selecione 'Generative' ou 'Drop' e configure suas definições. Deixe sem definir para não aplicar sombra.

Sobreposição de logotipo ou marca-d'água ativada ao fornecer uma imagem; omiti-la deixa a saída sem marca-d'água, como ocorre por padrã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 esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Pixelcut Product Photo

Processa uma foto de produto em uma imagem no estilo de catálogo. Você pode definir a tela com predefinições de `image_size` ou dimensões personalizadas, escolher um `background` sólido, transparente ou de imagem e ajustar a `margin`. Uma `shadow` generativa ou projetada e uma sobreposição opcional de `watermark` estão disponíveis. A saída é png ou jpeg, e jpeg não pode ser usado com fundo transparente.

Parâmetros

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

NomeTipo PadrãoPermitido Descrição
image_urlobrigatório image
Tipourl · image
URL da imagem do produto para processamento.
image_sizeopcional
Tipoobject
Padrãosquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões da tela de saída, especificadas como {width, height} personalizado ou uma predefinição: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. O padrão é square_hd (1024x1024).
backgroundopcional
Tipoobject
Plano de fundo da saída: uma imagem, transparência ou uma cor sólida que usa branco por padrão.
background.modeopcional
Tipoenum
PadrãoColor
TransparentColorImage
Modo de plano de fundo: 'Color' usa `color`, com branco como padrão; 'Transparent' produz transparência e sempre usa PNG; 'Image' compõe o resultado sobre `image_url`.
background.coloropcional
Tipoobject
Padrão{"b":255,"g":255,"r":255}
Preenchimento de fundo sólido para o modo 'Color', branco por padrão, especificado por componentes R/G/B variando de 0 a 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
PadrãoCover
CoverContainStretch
Escolha como ajustar a imagem de fundo à tela. 'Contain' preserva uma imagem ajustada com barras sobre `color`, enquanto 'Stretch' usa distorção para ajustar; 'Cover' preenche a tela cortando a imagem.
marginopcional
Tipoobject
Espaço entre o produto e as bordas da tela. Use `all` para definir todas as margens, com substituições opcionais para lados individuais; o padrão é 20% por lado.
margin.allopcional
Tipostring
Padrão20%
Margem uniforme em todos os lados, especificada como '%' da dimensão da tela, de 0 a 49%, ou em 'px' com 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 suas definições. Deixe sem definir para não aplicar 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
Configurações da sombra gerada por IA, aplicadas quando o tipo é 'Generative'.
shadow.generative.opacityopcional
Tiponumber
Padrã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 da imagem quando fornecida.
shadow.dropopcional
Tipoobject
Configurações da sombra projetada, aplicadas quando o tipo é 'Drop'.
shadow.drop.coloropcional
Tipoobject
Padrão{"b":0,"g":0,"r":0}
Cor RGB da sombra; preto é o padrão.
shadow.drop.horizontalopcional
Tiponumber
Padrão50
-100 – 100
Deslocamento horizontal da sombra, em que a configuração máxima de 100 representa 10% da largura da tela. Os valores variam de -100 a 100, com configurações negativas deslocando para a esquerda e positivas para a direita.
shadow.drop.verticalopcional
Tiponumber
Padrão8
-100 – 100
Deslocamento vertical da sombra, em que a configuração máxima de 100 representa 10% da altura da tela. Os valores variam de -100 a 100, com configurações negativas deslocando para cima e positivas para baixo.
shadow.drop.bluropcional
Tiponumber
Padrão24
0 – 100
Configuração de desfoque da sombra, com a suavidade máxima em 100 correspondente a um raio de 5% da menor dimensão da tela. O intervalo começa em 0, que mantém as bordas nítidas.
shadow.drop.opacityopcional
Tiponumber
Padrão0.25
0 – 1
Opacidade da sombra, de 0 a 1.
watermarkopcional
Tipoobject
Sobreposição de logotipo ou marca-d'água ativada ao fornecer uma imagem; omiti-la deixa a saída sem marca-d'água, como ocorre por padrão.
watermark.image_urlopcional
Tipourl · image
URL da imagem do logotipo ou da marca-d'água. Um valor vazio deixa a saída sem marca-d'água.
watermark.remove_backgroundopcional
Tipoboolean
Padrãofalse
Se o fundo da marca-d'água deve ser removido usando remoção de fundo para que a sobreposição não o inclua.
watermark.positionopcional
Tipoenum
Padrãobottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
Posicionamento da marca-d'água.
watermark.scaleopcional
Tiponumber
Padrão0.1
0,01 – 1
Largura da marca-d'água, expressa como uma fração da largura da tela.
watermark.opacityopcional
Tiponumber
Padrão1
0 – 1
Opacidade da marca-d'água, de 0 a 1.
watermark.marginopcional
Tipostring
Padrão3%
Distância para dentro a partir da borda da tela, expressa como '%' da tela (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. Omitir a seleção preserva o formato da entrada.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
image
object {url, content_type, file_name, file_size, width, height} | nullFotografia de produto preparada para uso em catálogo.

Mais modelos: Edição de imagem

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