تخطّي إلى المحتوى

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"

هذا الطلب: ⁨‏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' لتوليفه بالذكاء الاصطناعي أو 'Drop' لإنشاء ظل إسقاطي حتمي.
shadow.generativeاختياري
النوعobject
إعدادات الظل المُولّد بالذكاء الاصطناعي، وتُطبّق عندما يكون النوع '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://، أو 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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/ar/developers/models/pixelcut/product-photo.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt