דילוג לתוכן

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' לסינתזה באמצעות 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://, כתובת 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-חודש) או למשך 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/he/developers/models/pixelcut/product-photo.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt