ข้ามไปยังเนื้อหา

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' ค่าเริ่มต้นเป็นสีขาว ระบุผ่านองค์ประกอบ R/G/B ตั้งแต่ 0 ถึง 255
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% หรือเป็น 'px' โดยมีค่าต่ำสุด 0px
margin.leftไม่บังคับ
ประเภทstring | null
ระยะขอบด้านซ้ายที่แทนที่ `all` สำหรับด้านนั้น รับค่า '%' ตั้งแต่ 0 ถึง 49% หรือ 'px' ตั้งแต่ 0px ขึ้นไป
margin.rightไม่บังคับ
ประเภทstring | null
ระยะขอบด้านขวาที่แทนที่ `all` สำหรับด้านนั้น รับค่า '%' ตั้งแต่ 0 ถึง 49% หรือ 'px' ตั้งแต่ 0px ขึ้นไป
margin.topไม่บังคับ
ประเภทstring | null
ระยะขอบด้านบนที่แทนที่ `all` สำหรับด้านนั้น รับค่า '%' ตั้งแต่ 0 ถึง 49% หรือ 'px' ตั้งแต่ 0px ขึ้นไป
margin.bottomไม่บังคับ
ประเภทstring | null
ระยะขอบด้านล่างที่แทนที่ `all` สำหรับด้านนั้น รับค่า '%' ตั้งแต่ 0 ถึง 49% หรือ 'px' ตั้งแต่ 0px ขึ้นไป
shadowไม่บังคับ
ประเภทobject
การกำหนดค่าเงา: เลือก 'Generative' หรือ 'Drop' และกำหนดการตั้งค่า หากไม่กำหนดจะไม่ใช้เงา
shadow.typeไม่บังคับ
ประเภทenum
GenerativeDrop
รูปแบบเงาที่เป็นตัวเลือก หากไม่กำหนดจะไม่มีเงา เลือก 'Generative' สำหรับการสังเคราะห์ด้วย AI หรือ 'Drop' สำหรับเงาตกกระทบแบบกำหนดผลลัพธ์แน่นอน
shadow.generativeไม่บังคับ
ประเภทobject
การตั้งค่าสำหรับเงาที่สร้างด้วย AI ซึ่งใช้เมื่อประเภทเป็น 'Generative'
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 ซึ่งทำให้ขอบยังคม
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 ไม่พร้อมใช้งานสำหรับพื้นหลังโปร่งใส หากไม่เลือก จะคงรูปแบบของอินพุตไว้
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ 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 คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดล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/th/developers/models/pixelcut/product-photo.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt