דילוג לתוכן

Extract Object

שילוב

מזהה מודל bria/extract-object
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

בקשה זו: ⁨‏0.02 ‏$⁩ 20 קרדיטי API · ≈ ⁨‏2.11 ‏₽⁩ הרצה בדף הזה

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

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

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

בנה בקשה

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

האובייקט שעליו יש לפעול, המתואר בשפה טבעית, כגון 'the red car'.

מתקדם image · autocrop · remove_background
image_url ברירת מחדל https://bria-datasets...
גרור קובץ, או

תמונת מקור המסופקת באמצעות כתובת URL ציבורית, בתים גולמיים של תמונה בקידוד base64, או URI של נתוני base64 כגון data:image/png;base64,... .

POST /run/bria/extract-object?wait=20 הצעת מחיר → ⁨‏0.02 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Extract Object

מאתר בתמונה מ-`image_url` את האובייקט המתואר ב-`prompt` ומחזיר אותו על רקע שקוף, יחד עם מסכת הסגמנטציה. `autocrop` מצמצם את הקנבס לאובייקט. `remove_background` משפר את קצה החיתוך באמצעות הסרת הרקע במקום להסתמך רק על מסכת הסגמנטציה. אם אין התאמה, מוחזרת תמונת הקלט המלאה.

פרמטרים

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

שםסוג ברירת מחדלמותר תיאור
image_urlאופציונלי image
סוגurl · image
ברירת מחדלhttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
תמונת מקור המסופקת באמצעות כתובת URL ציבורית, בתים גולמיים של תמונה בקידוד base64, או URI של נתוני base64 כגון data:image/png;base64,... .
promptאופציונלי
סוגstring
ברירת מחדלyellow hammer
האובייקט שעליו יש לפעול, המתואר בשפה טבעית, כגון 'the red car'.
autocropאופציונלי
סוגboolean
ברירת מחדלfalse
חיתוך קנבס הפלט כך שיתאים לאובייקט שחולץ.
remove_backgroundאופציונלי
סוגboolean
ברירת מחדלfalse
מתג לשיפור אלפא בחיתוך. ברירת המחדל, False, מדלגת על יצירת מסכה לאובייקט בולט ולוקחת את האלפא ישירות מסגמנטציית SAM, וכך מאיצה את העיבוד ומסייעת לשמר טקסט, לוגואים או גרפיקה ש-RMBG עלול לחתוך יתר על המידה. הגדירו True כדי לשפר את האלפא באמצעות הסרת הרקע של RMBG.
חובה שם קנוני, מתקבל גם הוא

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

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/extract-object",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "yellow hammer"
  },
  "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
    },
    "mask": {
      "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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}תמונת המקור המלאה אם ההנחיה אינה מוצאת אובייקט תואם; אחרת, תוצאת RGBA עם האובייקט שחולץ מוקף בשקיפות.
mask
object {url, content_type, file_name, file_size, width, height}מסכת החילוץ, שמצב ברירת המחדל שלה במקרה שאין התאמה תלוי בקלט: תמונות RGBA מספקות את ערוץ האלפא שלהן, וכל שאר התמונות יוצרות מסכה לבנה לחלוטין.

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

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