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

Sam 3 1 · Video

التكامل

معرّف النموذج sam-3-1/video
# 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-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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.19 $⁩ 190 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

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

تقسيم فيديو باستخدام SAM 3.1 يتتبع ما يصل إلى 128 عنصرًا، مع إخراج mp4 أو webm

Meta · فيديو

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

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

إنشاء طلب

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

الافتراضي

موجّه تقسيم يدعم عدة كائنات متتبَّعة من خلال أوصاف مفصولة بفواصل، مثل 'person, cloth'.

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

عنوان URL لفيديو التقسيم.

متقدم video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type الافتراضي X264 (.mp4)

نوع مخرج الفيديو الناتج.

الافتراضي 0.5

حدّ الثقة للكشف؛ يؤدي خفض القيمة إلى زيادة عدد عمليات الكشف على حساب الدقة، ويتراوح النطاق بين 0.0 و1.0.

الافتراضي 16

الحد الأقصى لعدد الكائنات المتتبَّعة في الفيديو.

الافتراضي []

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

الافتراضي []

موجّهات المربعات المدرجة كصفوف إحداثيات (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/video?wait=20 عرض السعر → ⁨‏0.19 $⁩
# 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-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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

حول Sam 3 1 · Video

يقسّم العناصر ويتتبعها في فيديو باستخدام SAM 3.1 من `prompt` نصي مفصول بفواصل، أو نقاط أو مربعات. يحدد `max_num_objects` عدد العناصر المتتبعة، من 1 إلى 128 (الافتراضي 16). يتراوح `detection_threshold` من 0.1 إلى 1. يكون الناتج X264 (.mp4) أو VP9 (.webm).

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو التقسيم.
promptاختياري
النوعstring
الافتراضي
موجّه تقسيم يدعم عدة كائنات متتبَّعة من خلال أوصاف مفصولة بفواصل، مثل 'person, cloth'.
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
معرّف اختياري يجمع الموجّهات التي تحسّن كائنًا واحدًا. إذا قُدّم نص أيضًا كموجّه، يحدد هذا المعرّف الكائن المكتشف الذي تحسّنه تلك النقاط.
box_promptsاختياري
النوعobject[]
الافتراضي[]
موجّهات المربعات المدرجة كصفوف إحداثيات (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
معرّف اختياري لتجميع المربعات التي تحسّن كائنًا واحدًا.
apply_maskاختياري
النوعboolean
الافتراضيtrue
ما إذا كان يجب تطبيق التقنيع على الفيديو.
video_output_typeاختياري
النوعenum
الافتراضيX264 (.mp4)
X264 (.mp4)VP9 (.webm)
نوع مخرج الفيديو الناتج.
detection_thresholdاختياري
النوعnumber
الافتراضي0.5
0.1 – 1
حدّ الثقة للكشف؛ يؤدي خفض القيمة إلى زيادة عدد عمليات الكشف على حساب الدقة، ويتراوح النطاق بين 0.0 و1.0.
max_num_objectsاختياري
النوعinteger
الافتراضي16
1 – 128
الحد الأقصى لعدد الكائنات المتتبَّعة في الفيديو.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video",
  "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": 190,
    "usd": "0.19",
    "charged": 190,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "boundingbox_frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}الفيديو الناتج عن التقسيم.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullأرشيف ZIP لطبقات مربعات الإحاطة لكل إطار.

مزيد من النماذج: من فيديو إلى فيديو

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