رفتن به محتوا

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"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۱۰⁩ ۱۰۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Open model ویدیو به ویدیو #utility#editing

یک شیء را همراه با اثراتش بر صحنه از ویدیو حذف می‌کند و از ویدیوی ماسک یا متن ماسک استفاده می‌کند

Open model · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

توضیحی که مشخص می‌کند پس از حذف شیء، پس‌زمینه باید چگونه به نظر برسد.

•الزامی 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 قیمت → ⁨‎$۰٫۱۰⁩
# 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
۱ – ۵۰
تعداد گام‌های حذف نویز. افزایش آن کیفیت را بهتر می‌کند اما تأخیر را افزایش می‌دهد.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض1
۰ – ۲۰
قدرت راهنمایی بدون طبقه‌بند.
strengthاختیاری
نوعnumber
پیش‌فرض1
۰ – ۱
شدت حذف نویز؛ مقدار 1.0 نشان‌دهندهٔ حذف کامل نویز است.
seedاختیاری
نوعinteger | null
Seed کنترل‌کننده تصادفی‌بودن برای نتایج قابل‌بازآفرینی.
num_framesاختیاری
نوعinteger
پیش‌فرض85
۱ – ۱۹۷
پنجرهٔ استنتاج زمانی درخواستی که 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-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}ویدیوی نهایی پس از حذف شیء.
seed
integerمقدار Seed اعمال‌شده هنگام تولید.
timings
objectجزئیات زمان‌بندی هر مرحله از خط لوله.

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/void-video-inpainting.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt