דילוג לתוכן

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

חלון ההסקה הזמני המבוקש, המותאם על ידי ה-backend לאחד מהגדלים הבטוחים ל-CogVideoX: 69, 77, 85, ..., 197. נבחר הגודל הקרוב ביותר כדי להתאים לדחיסה זמנית ולחלוקה לטלאים.

Seed השולט באקראיות לקבלת תוצאות שניתנות לשחזור.

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
Seed השולט באקראיות לקבלת תוצאות שניתנות לשחזור.
num_framesאופציונלי
סוגinteger
ברירת מחדל85
1 – 197
חלון ההסקה הזמני המבוקש, המותאם על ידי ה-backend לאחד מהגדלים הבטוחים ל-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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}הווידאו שנוצר לאחר הסרת האובייקט.
seed
integerערך Seed המוחל במהלך היצירה.
timings
objectפרטי תזמון לכל שלב בצינור העיבוד.

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/void-video-inpainting.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt