رفتن به محتوا

Pixelcut Product Photo

یکپارچه‌سازی

شناسه مدل 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"

این درخواست: ⁨‎$۰٫۰۲۴⁩ ۲۴ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Pixelcut ویرایش تصویر #utility#editing

ترکیب‌کننده تصویر محصول: کالا را برش می‌دهد و با پس‌زمینه، حاشیه و سایه روی بوم جدید قرار می‌دهد

Pixelcut · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 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 قیمت → ⁨‎$۰٫۰۲۴⁩
# 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
۰ – ۲۵۵
background.color.gالزامی
نوعinteger
۰ – ۲۵۵
background.color.bالزامی
نوعinteger
۰ – ۲۵۵
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
سبک اختیاری سایه؛ در صورت تنظیم‌نشدن، سایه‌ای اعمال نمی‌شود. برای سنتز AI گزینه 'Generative' و برای سایه افتاده قطعی گزینه 'Drop' را انتخاب کنید.
shadow.generativeاختیاری
نوعobject
تنظیمات سایه تولیدشده توسط AI که هنگام انتخاب نوع 'Generative' اعمال می‌شوند.
shadow.generative.opacityاختیاری
نوعnumber
پیش‌فرض0.2
۰ – ۱
شفافیت سایه کاملاً ترکیب‌شده، از 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 برابر با 10% عرض بوم است. مقادیر از -100 تا 100 هستند؛ مقادیر منفی سایه را به چپ و مقادیر مثبت آن را به راست می‌برند.
shadow.drop.verticalاختیاری
نوعnumber
پیش‌فرض8
−۱۰۰ – ۱۰۰
جابجایی عمودی سایه؛ حداکثر مقدار 100 برابر با 10% ارتفاع بوم است. مقادیر از -100 تا 100 هستند؛ مقادیر منفی سایه را به بالا و مقادیر مثبت آن را به پایین می‌برند.
shadow.drop.blurاختیاری
نوعnumber
پیش‌فرض24
۰ – ۱۰۰
تنظیم تاری سایه؛ بیشترین نرمی در مقدار 100 با شعاعی برابر با 5% بُعد کوتاه‌تر بوم متناظر است. بازه از 0 شروع می‌شود که لبه‌ها را سخت نگه می‌دارد.
shadow.drop.opacityاختیاری
نوعnumber
پیش‌فرض0.25
۰ – ۱
شفافیت سایه، از 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
۰٫۰۱ – ۱
عرض واترمارک، به‌صورت کسری از عرض بوم.
watermark.opacityاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
شفافیت واترمارک، از 0 تا 1.
watermark.marginاختیاری
نوعstring
پیش‌فرض3%
فاصله به سمت داخل از لبه بوم، به‌صورت درصد '%' از بوم (0–49%) یا به‌صورت 'px'.
output_formatاختیاری
نوعenum
pngjpeg
کدگذاری تصویر خروجی؛ از PNG یا JPEG انتخاب می‌شود و JPEG برای پس‌زمینه‌های شفاف در دسترس نیست. حذف این انتخاب، قالب ورودی را حفظ می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 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-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size, width, height} | nullعکس محصول آماده‌شده برای استفاده در کاتالوگ.

مدل‌های بیشتر: ویرایش تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/pixelcut/product-photo.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt