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

Segment Anything Model 3

التكامل

معرّف النموذج sam-3/image
# 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/sam-3/image?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.005 $⁩ 5 أرصدة API تشغيله في هذه الصفحة

الحصول على مفتاح API
Meta تحرير الصور #segmentation#mask#real-time

تقسيم صورة بمطالبات نصية أو نقطية أو مربعة، يعيد صور الأقنعة مع درجات ومربعات اختيارية

Meta · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

الافتراضي wheel

تعليمة نصية لتوجيه التقسيم.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL يشير إلى الصورة المراد تقسيمها.

متقدم text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] مدخل قديم محتفظ به للتوافق مع الإصدارات السابقة؛ استخدم 'prompt' بدلًا منه.

output_format الافتراضي png

تنسيق ملف الصورة الناتجة.

الافتراضي 3

الحد الأقصى للأقنعة المُعادة عند تفعيل `return_multiple_masks`.

الافتراضي []

مجموعة من الموجّهات القائمة على النقاط.

الافتراضي []

موجّهات مربعات يحدد object_id فيها التجميع: تربط المعرّفات المتطابقة المربعات بكائن واحد، بينما تمثل المعرّفات الفارغة كائنات منفصلة. يمكن تقديم عدة مربعات، يستخدم كل منها الإحداثيات (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 عرض السعر → ⁨‏0.005 $⁩
# 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/sam-3/image?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

حول Segment Anything Model 3

يقسم صورة باستخدام SAM 3 من مطالبة نصية `prompt` أو `point_prompts` أو `box_prompts`. عند تفعيل `return_multiple_masks` يعيد ما يصل إلى `max_masks` من الأقنعة (من 1 إلى 32). يمكن تضمين درجات الثقة والمربعات المحيطة اختياريًا. تنسيق الإخراج هو jpeg أو png أو webp.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL يشير إلى الصورة المراد تقسيمها.
promptاختياري
النوعstring
الافتراضيwheel
تعليمة نصية لتوجيه التقسيم.
text_promptاختياري
النوعstring | null
[DEPRECATED] مدخل قديم محتفظ به للتوافق مع الإصدارات السابقة؛ استخدم 'prompt' بدلًا منه.
point_promptsاختياري
النوعobject[]
الافتراضي[]
مجموعة من الموجّهات القائمة على النقاط.
point_prompts[].xاختياري
النوعinteger | null
موضع الموجّه على محور X.
point_prompts[].yاختياري
النوعinteger | null
موضع الموجّه على محور Y.
point_prompts[].labelاختياري
النوعenum
01
تسمية المقدمة/الخلفية: يشير 1 إلى المقدمة؛ ويشير 0 إلى الخلفية.
point_prompts[].object_idاختياري
النوعinteger | null
معرّف اختياري يجمع الموجّهات التي تحسّن كائنًا واحدًا. إذا قُدّم نص أيضًا كموجّه، يحدد هذا المعرّف الكائن المكتشف الذي تحسّنه تلك النقاط.
point_prompts[].frame_indexاختياري
النوعinteger | null
فهرس يحدد إطار التفاعل.
box_promptsاختياري
النوعobject[]
الافتراضي[]
موجّهات مربعات يحدد object_id فيها التجميع: تربط المعرّفات المتطابقة المربعات بكائن واحد، بينما تمثل المعرّفات الفارغة كائنات منفصلة. يمكن تقديم عدة مربعات، يستخدم كل منها الإحداثيات (x_min, y_min, x_max, y_max).
box_prompts[].x_minاختياري
النوعinteger | null
الحد الأدنى لإحداثي x للصندوق.
box_prompts[].y_minاختياري
النوعinteger | null
الحد الأدنى لإحداثي y للصندوق.
box_prompts[].x_maxاختياري
النوعinteger | null
إحداثي X الأقصى للمربع.
box_prompts[].y_maxاختياري
النوعinteger | null
إحداثي Y الأقصى للمربع.
box_prompts[].object_idاختياري
النوعinteger | null
معرّف اختياري لتجميع المربعات التي تحسّن كائنًا واحدًا.
box_prompts[].frame_indexاختياري
النوعinteger | null
فهرس يحدد إطار التفاعل.
apply_maskاختياري
النوعboolean
الافتراضيtrue
يتحكم في تطبيق القناع على الصورة.
output_formatاختياري
النوعenum
الافتراضيpng
jpegpngwebp
تنسيق ملف الصورة الناتجة.
return_multiple_masksاختياري
النوعboolean
الافتراضيfalse
خيار إرجاع أقنعة متعددة: يؤدي تفعيله إلى استخدام `max_masks` لتحديد عدد الأقنعة المُولَّدة التي تُرفع وتُدرج في الاستجابة.
max_masksاختياري
النوعinteger
الافتراضي3
1 – 32
الحد الأقصى للأقنعة المُعادة عند تفعيل `return_multiple_masks`.
include_scoresاختياري
النوعboolean
الافتراضيfalse
يتحكم في تضمين درجات الثقة للأقنعة.
include_boxesاختياري
النوعboolean
الافتراضيfalse
يتحكم في تضمين مربع إحاطة لكل قناع، إن توفر.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/image",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "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
    },
    "masks": [
      {
        "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
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "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معاينة تعرض قناع التقسيم الأساسي.
masks
array of object {url, content_type, file_name, file_size, width, height}صور تحتوي على أقنعة التقسيم.
metadata
array of object {index, score, box} | nullبيانات وصفية لكل قناع، بما في ذلك درجته ومربع الإحاطة.
scores
array of number | nullدرجة الثقة لكل قناع، تُقدَّم عند طلبها.
boxes
array of array of number | nullمربعات مُطبَّعة لكل قناع، بصيغة [cx, cy, w, h]، عند طلبها.

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

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