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

Void Video Inpainting

التكامل

معرّف النموذج void-video-inpainting
# 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/void-video-inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

الحصول على مفتاح API
Open model من فيديو إلى فيديو #utility#editing

يزيل عنصرًا من الفيديو وتأثيراته على المشهد باستخدام فيديو قناع أو مطالبة نصية للقناع

Open model · فيديو

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

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

إنشاء طلب

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

•مطلوب

وصف يحدد شكل الخلفية بعد إزالة الكائن.

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

عنوان URL لفيديو المصدر الذي يحتوي على الكائن المستهدف للإزالة.

الافتراضي
أفلت ملفًا، أو

عنوان URL لفيديو قناع الإزالة؛ عند غيابه، ينشئ التطبيق قناع فيديو مؤقتًا عبر نقطة نهاية فيديو SAM-3 باستخدام `mask_prompt`، ثم يحوله تلقائيًا إلى quadmask. لأفضل النتائج، قدّم quadmask بنمط VOID باستخدام 4 قيم رمادية: 255 للخلفية المحتفظ بها، و127 للمنطقة المتأثرة، و63 للتداخل، و0 للكائن المُزال. تُقبل الأقنعة الثنائية أيضًا، باستخدام 255 للإبقاء و0 للإزالة.

متقدم mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

تعليمات الهدف للقناع لكي ينشئ SAM-3 فيديو قناع مؤقتًا عند عدم توفير `quad_mask_video_url`. حدّد ما يجب قناعه، مثل كائن أو شخص لإزالته من فيديو المصدر.

الافتراضي The video is not of a...

موجّه سلبي يصف النتائج غير المرغوبة لتوجيه التوليد بعيدًا عنها.

الافتراضي 30

عدد خطوات إزالة التشويش. تؤدي زيادته إلى تحسين الجودة مع إضافة زمن تأخير.

الافتراضي 1

قوة التوجيه الخالي من المصنف.

الافتراضي 1

قوة إزالة التشويش، حيث تشير 1.0 إلى إزالة تشويش كاملة.

الافتراضي 85

نافذة الاستدلال الزمني المطلوبة، ويضبطها النظام الخلفي إلى أحد الأحجام الآمنة لـ CogVideoX: 69 و77 و85 و... و197. يُختار أقرب حجم مناسب لاستيعاب الضغط الزمني والتقسيم إلى رقع.

بذرة تتحكم في العشوائية للحصول على نتائج قابلة لإعادة الإنتاج.

POST /run/void-video-inpainting?wait=20 عرض السعر → ⁨‏0.10 $⁩
# 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/void-video-inpainting?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",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

حول Void Video Inpainting

يستقبل `video_url` و`prompt` يصف الخلفية المطلوبة. قدم `quad_mask_video_url` أو استخدم `mask_prompt` لإنشاء قناع. تشمل عناصر التحكم `num_frames` (1-197) و`num_inference_steps` (1-50) و`guidance_scale` و`strength` وخيار `enable_pass2_refinement` الأبطأ لتحقيق الاتساق الزمني.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL لفيديو المصدر الذي يحتوي على الكائن المستهدف للإزالة.
quad_mask_video_urlاختياري
النوعurl · video
الافتراضي
عنوان URL لفيديو قناع الإزالة؛ عند غيابه، ينشئ التطبيق قناع فيديو مؤقتًا عبر نقطة نهاية فيديو SAM-3 باستخدام `mask_prompt`، ثم يحوله تلقائيًا إلى quadmask. لأفضل النتائج، قدّم quadmask بنمط VOID باستخدام 4 قيم رمادية: 255 للخلفية المحتفظ بها، و127 للمنطقة المتأثرة، و63 للتداخل، و0 للكائن المُزال. تُقبل الأقنعة الثنائية أيضًا، باستخدام 255 للإبقاء و0 للإزالة.
mask_promptاختياري
النوعstring | null
تعليمات الهدف للقناع لكي ينشئ SAM-3 فيديو قناع مؤقتًا عند عدم توفير `quad_mask_video_url`. حدّد ما يجب قناعه، مثل كائن أو شخص لإزالته من فيديو المصدر.
promptمطلوب
النوعstring
وصف يحدد شكل الخلفية بعد إزالة الكائن.
enable_pass2_refinementاختياري
النوعboolean
الافتراضيfalse
تحسين VOID اختياري يستبدل سرعة معالجة أقل باتساق زمني أفضل محتمل في المقاطع الطويلة. يطبّق تحسين الضوضاء المُحوّلة كـ Pass 2 بعد Pass 1.
negative_promptاختياري
النوعstring
الافتراضيThe video is not of a high quality, it has a low resolution. Watermark present in each frame. The background is solid. Strange body and strange trajectory. Distortion.
موجّه سلبي يصف النتائج غير المرغوبة لتوجيه التوليد بعيدًا عنها.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
1 – 50
عدد خطوات إزالة التشويش. تؤدي زيادته إلى تحسين الجودة مع إضافة زمن تأخير.
guidance_scaleاختياري
النوعnumber
الافتراضي1
0 – 20
قوة التوجيه الخالي من المصنف.
strengthاختياري
النوعnumber
الافتراضي1
0 – 1
قوة إزالة التشويش، حيث تشير 1.0 إلى إزالة تشويش كاملة.
seedاختياري
النوعinteger | null
بذرة تتحكم في العشوائية للحصول على نتائج قابلة لإعادة الإنتاج.
num_framesاختياري
النوعinteger
الافتراضي85
1 – 197
نافذة الاستدلال الزمني المطلوبة، ويضبطها النظام الخلفي إلى أحد الأحجام الآمنة لـ CogVideoX: 69 و77 و85 و... و197. يُختار أقرب حجم مناسب لاستيعاب الضغط الزمني والتقسيم إلى رقع.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
تمكين فحوصات السلامة للمحتوى المُولّد.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "void-video-inpainting",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
    },
    "seed": 42,
    "timings": {}
  },
  "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}الفيديو الناتج بعد إزالة الكائن.
seed
integerقيمة البذرة المطبّقة أثناء التوليد.
timings
objectتفاصيل التوقيت لكل مرحلة في خط المعالجة.

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