콘텐츠로 건너뛰기

Pixelcut Product Photo

통합

모델 id 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"

이 요청: $0.024 24 API 크레딧 이 페이지에서 실행

API 키 받기
Pixelcut 이미지 편집 #utility#editing

상품 이미지 합성기: 상품을 분리해 배경, 여백, 그림자가 있는 새 캔버스에 배치합니다

Pixelcut · 이미지

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 image_url
파일을 끌어다 놓거나

처리할 제품 이미지 URL입니다.

image_size 기본값 square_hd

출력 캔버스 크기입니다. 사용자 지정 {width, height} 또는 square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 프리셋으로 지정합니다. 기본값은 square_hd (1024x1024)입니다.

고급 output_format · background · margin · shadow · watermark
output_format

PNG 또는 JPEG 중에서 선택하는 출력 이미지 인코딩이며, 투명한 배경에서는 JPEG를 사용할 수 없습니다. 선택을 생략하면 입력 형식이 유지됩니다.

출력 배경입니다. 이미지, 투명 또는 기본값이 흰색인 단색을 사용할 수 있습니다.

제품과 캔버스 가장자리 사이의 간격입니다. `all`을 사용하면 모든 여백을 설정하며, 개별 변을 선택적으로 재정의할 수 있습니다. 기본값은 변마다 20%입니다.

그림자 설정입니다. 'Generative' 또는 'Drop'을 선택하고 설정을 구성합니다. 설정하지 않으면 그림자를 적용하지 않습니다.

이미지를 제공하면 로고 또는 워터마크 오버레이를 활성화합니다. 생략하면 기본값처럼 출력에 워터마크가 없습니다.

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

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Pixelcut Product Photo 정보

상품 사진을 카탈로그 스타일 이미지로 처리합니다. `image_size` 프리셋 또는 사용자 지정 크기로 캔버스를 설정하고, 단색·투명 또는 이미지 `background`를 선택하며 `margin`을 조정할 수 있습니다. 생성형 또는 드롭 `shadow`와 선택적 `watermark` 오버레이를 사용할 수 있습니다. 출력은 png 또는 jpeg이며, 투명 배경에는 jpeg를 사용할 수 없습니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
image_url필수 image
유형url · image
처리할 제품 이미지 URL입니다.
image_size선택 사항
유형object
기본값square_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
출력 캔버스 크기입니다. 사용자 지정 {width, height} 또는 square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 프리셋으로 지정합니다. 기본값은 square_hd (1024x1024)입니다.
background선택 사항
유형object
출력 배경입니다. 이미지, 투명 또는 기본값이 흰색인 단색을 사용할 수 있습니다.
background.mode선택 사항
유형enum
기본값Color
TransparentColorImage
배경 모드입니다. 'Color'는 `color`를 사용하며 기본값은 흰색입니다. 'Transparent'는 투명 배경을 만들고 항상 PNG를 사용합니다. 'Image'는 `image_url` 위에 결과를 합성합니다.
background.color선택 사항
유형object
기본값{"b":255,"g":255,"r":255}
'Color' 모드의 단색 배경 채우기입니다. 기본값은 흰색이며 0~255 범위의 R/G/B 구성 요소로 지정합니다.
background.color.r필수
유형integer
0 – 255
background.color.g필수
유형integer
0 – 255
background.color.b필수
유형integer
0 – 255
background.image_url선택 사항
유형url · image
배경 이미지 URL입니다. 'Image' 모드에서는 필수입니다.
background.image_fit선택 사항
유형enum
기본값Cover
CoverContainStretch
배경 이미지를 캔버스에 맞추는 방법을 선택합니다. 'Contain'은 `color` 위에 레터박스를 적용해 맞춘 이미지 전체를 유지하고, 'Stretch'는 왜곡해 맞추며, 'Cover'는 잘라내 캔버스를 채웁니다.
margin선택 사항
유형object
제품과 캔버스 가장자리 사이의 간격입니다. `all`을 사용하면 모든 여백을 설정하며, 개별 변을 선택적으로 재정의할 수 있습니다. 기본값은 변마다 20%입니다.
margin.all선택 사항
유형string
기본값20%
모든 변에 적용되는 균일한 여백입니다. 캔버스 크기의 '%'로 0~49% 범위에서 지정하거나 최소 0px의 'px'로 지정합니다.
margin.left선택 사항
유형string | null
해당 변에서 `all`을 대체하는 왼쪽 여백입니다. 0~49%의 '%' 또는 0px 이상의 'px'를 사용할 수 있습니다.
margin.right선택 사항
유형string | null
해당 변에서 `all`을 대체하는 오른쪽 여백입니다. 0~49%의 '%' 또는 0px 이상의 'px'를 사용할 수 있습니다.
margin.top선택 사항
유형string | null
해당 변에서 `all`을 대체하는 위쪽 여백입니다. 0~49%의 '%' 또는 0px 이상의 'px'를 사용할 수 있습니다.
margin.bottom선택 사항
유형string | null
해당 변에서 `all`을 대체하는 아래쪽 여백입니다. 0~49%의 '%' 또는 0px 이상의 'px'를 사용할 수 있습니다.
shadow선택 사항
유형object
그림자 설정입니다. 'Generative' 또는 'Drop'을 선택하고 설정을 구성합니다. 설정하지 않으면 그림자를 적용하지 않습니다.
shadow.type선택 사항
유형enum
GenerativeDrop
선택적 그림자 스타일입니다. 설정하지 않으면 그림자를 사용하지 않습니다. AI 합성에는 'Generative', 결정적 드롭 그림자에는 'Drop'을 선택합니다.
shadow.generative선택 사항
유형object
유형이 'Generative'일 때 적용되는 AI 생성 그림자 설정입니다.
shadow.generative.opacity선택 사항
유형number
기본값0.2
0 – 1
완전히 합성된 그림자의 불투명도로, 0~1입니다.
shadow.generative.light_source선택 사항
유형object
그림자 합성을 위한 명시적 가상 광원입니다. 제공하면 이미지에서 광원 방향을 자동 추정하는 대신 사용합니다.
shadow.drop선택 사항
유형object
유형이 'Drop'일 때 적용되는 드롭 그림자 설정입니다.
shadow.drop.color선택 사항
유형object
기본값{"b":0,"g":0,"r":0}
그림자의 RGB 색상입니다. 기본값은 검은색입니다.
shadow.drop.horizontal선택 사항
유형number
기본값50
-100 – 100
가로 그림자 이동입니다. 최대 설정 100은 캔버스 너비의 10%를 나타냅니다. 범위는 -100~100이며, 음수는 왼쪽, 양수는 오른쪽으로 이동합니다.
shadow.drop.vertical선택 사항
유형number
기본값8
-100 – 100
세로 그림자 이동입니다. 최대 설정 100은 캔버스 높이의 10%를 나타냅니다. 범위는 -100~100이며, 음수는 위쪽, 양수는 아래쪽으로 이동합니다.
shadow.drop.blur선택 사항
유형number
기본값24
0 – 100
그림자 흐림 설정입니다. 최대 부드러움 100은 짧은 캔버스 변의 5% 반경에 해당합니다. 범위는 0부터 시작하며 0에서는 가장자리가 선명하게 유지됩니다.
shadow.drop.opacity선택 사항
유형number
기본값0.25
0 – 1
그림자의 불투명도로, 0~1입니다.
watermark선택 사항
유형object
이미지를 제공하면 로고 또는 워터마크 오버레이를 활성화합니다. 생략하면 기본값처럼 출력에 워터마크가 없습니다.
watermark.image_url선택 사항
유형url · image
로고 또는 워터마크 이미지 URL입니다. 빈 값이면 워터마크 없이 출력합니다.
watermark.remove_background선택 사항
유형boolean
기본값false
배경 제거를 사용해 워터마크의 배경을 제거할지 여부입니다. 제거하면 오버레이에서 배경이 제외됩니다.
watermark.position선택 사항
유형enum
기본값bottom_right
top_lefttop_rightbottom_leftbottom_rightcenter
워터마크 배치 위치입니다.
watermark.scale선택 사항
유형number
기본값0.1
0.01 – 1
캔버스 너비에 대한 비율로 표현한 워터마크 너비입니다.
watermark.opacity선택 사항
유형number
기본값1
0 – 1
워터마크의 불투명도로, 0~1입니다.
watermark.margin선택 사항
유형string
기본값3%
캔버스 가장자리에서 안쪽으로의 거리입니다. 캔버스의 '%'로 0~49% 범위에서 지정하거나 'px'로 지정합니다.
output_format선택 사항
유형enum
pngjpeg
PNG 또는 JPEG 중에서 선택하는 출력 이미지 인코딩이며, 투명한 배경에서는 JPEG를 사용할 수 없습니다. 선택을 생략하면 입력 형식이 유지됩니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

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"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
image
object {url, content_type, file_name, file_size, width, height} | null카탈로그용으로 준비된 제품 사진입니다.

더 많은 모델: 이미지 편집

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/pixelcut/product-photo.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt