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

Sam 3 · Video RLE

التكامل

معرّف النموذج sam-3/video-rle
# 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/sam-3/video-rle?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.095 $⁩ 95 رصيد API · ≈ ⁨‏9.95 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

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

تجزئة الفيديو مع تهيئة من عنوان URL للقناع، والتحكم في فهرس الإطار، وحد أدنى أقل لعتبة الاكتشاف

Meta · فيديو

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

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

إنشاء طلب

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

الافتراضي

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

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

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

متقدم mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
أفلت ملفًا، أو

عنوان URL للقناع المستخدم في التطبيق الأولي.

الافتراضي 0.5

حدّ الثقة للكشف، وقيمته الافتراضية 0.5 للكائنات الموجودة و0.7 للكائنات الجديدة. ضمن النطاق 0.0–1.0، تستبدل القيم الأصغر الدقة بزيادة عدد عمليات الكشف؛ جرّب 0.2–0.3 عند فشل الموجّهات النصية.

الافتراضي 0

فهرس الإطار الخاص بالتفاعل الأولي عند توفير mask_url.

الافتراضي []

قائمة موجّهات النقاط التي تحدد فهارس الإطارات.

الافتراضي []

قائمة موجّهات المربعات، مع frame_index اختياري لكل إدخال.

POST /run/sam-3/video-rle?wait=20 عرض السعر → ⁨‏0.095 $⁩
# 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/sam-3/video-rle?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Sam 3 · Video RLE

يُجزّئ الفيديو باستخدام SAM 3 عبر `prompt` نصي أو مطالبات نقطية أو مستطيلة أو قناع أولي من `mask_url` مطبّق عند `frame_index`. تتراوح قيمة `detection_threshold` من 0.01 إلى 1، وقد تساعد القيم الأقل مثل 0.2 إلى 0.3 عند فشل المطالبات النصية. ويمكنه إعادة ملف zip للمستطيلات المحيطة لكل إطار عبر `boundingbox_zip`.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو التقسيم.
mask_urlاختياري mask
النوعurl · image
عنوان 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
معرّف اختياري يجمع الموجّهات التي تحسّن كائنًا واحدًا. إذا قُدّم نص أيضًا كموجّه، يحدد هذا المعرّف الكائن المكتشف الذي تحسّنه تلك النقاط.
point_prompts[].frame_indexاختياري
النوعinteger | null
فهرس يحدد إطار التفاعل.
box_promptsاختياري
النوعobject[]
الافتراضي[]
قائمة موجّهات المربعات، مع frame_index اختياري لكل إدخال.
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
الافتراضيfalse
ما إذا كان يجب تطبيق التقنيع على الفيديو.
boundingbox_zipاختياري
النوعboolean
الافتراضيfalse
ما إذا كان يجب إرجاع أرشيف ZIP يتضمن طبقات مربعات الإحاطة لكل إطار.
detection_thresholdاختياري
النوعnumber
الافتراضي0.5
0.01 – 1
حدّ الثقة للكشف، وقيمته الافتراضية 0.5 للكائنات الموجودة و0.7 للكائنات الجديدة. ضمن النطاق 0.0–1.0، تستبدل القيم الأصغر الدقة بزيادة عدد عمليات الكشف؛ جرّب 0.2–0.3 عند فشل الموجّهات النصية.
frame_indexاختياري
النوعinteger
الافتراضي0
فهرس الإطار الخاص بالتفاعل الأولي عند توفير mask_url.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/video-rle",
  "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": 95,
    "usd": "0.095",
    "charged": 95,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/video-rle.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt