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

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.02 $⁩ 20 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Extract Object

يعثر على الكائن الموصوف في `prompt` داخل الصورة الموجودة في `image_url` ويعيده على خلفية شفافة مع قناع التجزئة. يضبط `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 تتخطى استخراج الكائن البارز وتستخرج alpha مباشرة من تقسيم SAM، ما يسرّع المعالجة ويساعد في الحفاظ على النصوص والشعارات والرسومات التي قد يقتطعها RMBG بشكل مفرط. اضبطها على True لتحسين alpha باستخدام إزالة الخلفية في 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.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}صورة المصدر الكاملة إذا لم يجد الموجّه كائنًا مطابقًا؛ وإلا فهي نتيجة RGBA تحتوي على الكائن المستخرج محاطًا بالشفافية.
mask
object {url, content_type, file_name, file_size, width, height}قناع الاستخراج الذي يعتمد البديل عند عدم العثور على تطابق فيه على المدخل: توفر صور RGBA قناة alpha الخاصة بها، بينما تنتج جميع الصور الأخرى قناعًا أبيض بالكامل.

مزيد من النماذج: تحرير الصور

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/bria/extract-object.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt