דילוג לתוכן

Bria Product Shot

שילוב

מזהה מודל bria/product-shot
# 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/bria/product-shot?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.04 ‏$⁩ 40 קרדיטי API הרצה בדף הזה

קבלת מפתח API
Bria AI · תמונה

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה image_url
גרור קובץ, או

כתובת URL של תמונת המוצר למיקום בסצנת סגנון חיים; התמונה חייבת להיות jpeg, jpg, png, webp ובגודל של עד 12 MB. אם מסופק גם `image_file`, ‏`image_url` מקבל עדיפות.

ברירת מחדל 1

מספר תמונות מוצר בסגנון חיים לכל מיקום (`num_results`). הסכום הכולל הוא מספר המיקומים הנדרשים × `num_results` עבור `placement_type=manual_placement`, או `num_results` × 10 עבור `placement_type=automatic`.

מתקדם ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
ברירת מחדל
גרור קובץ, או

כתובת URL של תמונת ייחוס ליצירת רקע או סצנה חדשים לתמונת מוצר, עם תמיכה ב-jpeg, jpg, png ו-webp. יש לספק בדיוק אחד מבין `scene_description` או `ref_image_url`; כתובת URL ריקה נכתבת כ-"". כאשר מסופק גם `ref_image_file`, ‏`ref_image_url` מקבל עדיפות.

placement_type ברירת מחדל manual_placement

מצב מיקום המוצר, עם שתי אפשרויות ידניות: 'manual_placement' משתמש במיקומים מוגדרים מראש שנבחרו באמצעות 'manual_placement_selection', ואילו 'manual_padding' מתאים את מיקום התמונה ואת גודלה באמצעות ריפוד בפיקסלים סביב המוצר. כדי לשמור על מיקום המקור, בחר 'original'; כדי ליצור תוצאות על פני 10 מיקומי מוצר מומלצים, בחר 'automatic'.

הנחיה באנגלית בלבד, ללא תווים מיוחדים, המתארת את הסצנה או הרקע שיש ליצור עבור תמונת המוצר שסופקה.

ברירת מחדל bottom_center

מיקומים מוגדרים מראש לשימוש כאשר placement_type=manual_placement נבחר. בחר מהרשימה; ניתן לבקש כמה מיקומים יחד.

ברירת מחדל [1000,1000]

מידות היעד של תמונת המוצר הסופית, הרלוונטיות רק עם placement_type=automatic או placement_type=manual_placement. לקבלת התוצאות הטובות ביותר, מומלץ לכוון לכ-1,000,000 פיקסלים בסך הכול.

ריפוד בפיקסלים עבור `placement_type=manual_padding`, המסופק כ-[left, right, top, bottom]. כדי לבחור את הערכים האלה, השג תחילה חיתוך מוצר באמצעות Product Cutout API ובדוק את מידותיו, ולאחר מכן העבר את החיתוך הזה ל-API עם הריפוד הרצוי. לקבלת תוצאות מיטביות, כוון לכ-1,000,000 פיקסלים בסך הכול לאחר הריפוד.

POST /run/bria/product-shot?wait=20 הצעת מחיר → ⁨‏0.04 ‏$⁩
# 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/bria/product-shot?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

מידע על Bria Product Shot

מכניס את המוצר מ-`image_url` לסצנה המתוארת ב-`scene_description` או המוצגת ב-`ref_image_url`, אך לא בשניהם. `placement_type` יכול להיות original, automatic, manual_placement או manual_padding, עם עשרה מיקומים של `manual_placement_selection` ו-`shot_size` של כ-1,000,000 פיקסלים. `num_results` נע בין 1 ל-4, וזמין מצב `fast`.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
image_urlחובה image
סוגurl · image
כתובת URL של תמונת המוצר למיקום בסצנת סגנון חיים; התמונה חייבת להיות jpeg, jpg, png, webp ובגודל של עד 12 MB. אם מסופק גם `image_file`, ‏`image_url` מקבל עדיפות.
scene_descriptionאופציונלי
סוגstring | null
הנחיה באנגלית בלבד, ללא תווים מיוחדים, המתארת את הסצנה או הרקע שיש ליצור עבור תמונת המוצר שסופקה.
ref_image_urlאופציונלי
סוגurl · image
ברירת מחדל
כתובת URL של תמונת ייחוס ליצירת רקע או סצנה חדשים לתמונת מוצר, עם תמיכה ב-jpeg, jpg, png ו-webp. יש לספק בדיוק אחד מבין `scene_description` או `ref_image_url`; כתובת URL ריקה נכתבת כ-"". כאשר מסופק גם `ref_image_file`, ‏`ref_image_url` מקבל עדיפות.
optimize_descriptionאופציונלי
סוגboolean
ברירת מחדלtrue
האם אופטימיזציה של תיאור הסצנה מופעלת.
num_resultsאופציונלי
סוגinteger
ברירת מחדל1
1 – 4
מספר תמונות מוצר בסגנון חיים לכל מיקום (`num_results`). הסכום הכולל הוא מספר המיקומים הנדרשים × `num_results` עבור `placement_type=manual_placement`, או `num_results` × 10 עבור `placement_type=automatic`.
fastאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם המודל המהיר נבחר.
placement_typeאופציונלי
סוגenum
ברירת מחדלmanual_placement
originalautomaticmanual_placementmanual_padding
מצב מיקום המוצר, עם שתי אפשרויות ידניות: 'manual_placement' משתמש במיקומים מוגדרים מראש שנבחרו באמצעות 'manual_placement_selection', ואילו 'manual_padding' מתאים את מיקום התמונה ואת גודלה באמצעות ריפוד בפיקסלים סביב המוצר. כדי לשמור על מיקום המקור, בחר 'original'; כדי ליצור תוצאות על פני 10 מיקומי מוצר מומלצים, בחר 'automatic'.
original_qualityאופציונלי
סוגboolean
ברירת מחדלfalse
אפשרות שינוי גודל הפלט, המשמשת רק עם `placement_type=original`: false משנה את גודל התמונה ל-1 מגה־פיקסל (1MP) בלי לשנות את יחס הגובה־רוחב, ואילו true שומר על מידות הקלט.
shot_sizeאופציונלי
סוגinteger[]
ברירת מחדל[1000,1000]
מידות היעד של תמונת המוצר הסופית, הרלוונטיות רק עם placement_type=automatic או placement_type=manual_placement. לקבלת התוצאות הטובות ביותר, מומלץ לכוון לכ-1,000,000 פיקסלים בסך הכול.
manual_placement_selectionאופציונלי
סוגenum
ברירת מחדלbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
מיקומים מוגדרים מראש לשימוש כאשר placement_type=manual_placement נבחר. בחר מהרשימה; ניתן לבקש כמה מיקומים יחד.
padding_valuesאופציונלי
סוגinteger[]
ריפוד בפיקסלים עבור `placement_type=manual_padding`, המסופק כ-[left, right, top, bottom]. כדי לבחור את הערכים האלה, השג תחילה חיתוך מוצר באמצעות Product Cutout API ובדוק את מידותיו, ולאחר מכן העבר את החיתוך הזה ל-API עם הריפוד הרצוי. לקבלת תוצאות מיטביות, כוון לכ-1,000,000 פיקסלים בסך הכול לאחר הריפוד.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/product-shot",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "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 הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
images
array of object {url, content_type, file_name, file_size, width, height}תמונות שנוצרו על ידי המודל.

מודלים נוספים: עריכת תמונה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/bria/product-shot.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt