رفتن به محتوا

Workflow Utilities Scale Video

یکپارچه‌سازی

شناسه مدل workflow-utilities/scale-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/workflow-utilities/scale-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"

تا ⁨‎$۳٫۶۰⁩ برای هر اجرا بر اساس مصرف واقعی هزینه دریافت می‌شود و مابقی بازپرداخت می‌شود اجرای آن در این صفحه

دریافت کلید API
Utility · ویدیو

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

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

ساخت درخواست

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

•الزامی video_url
یک فایل بیندازید، یا

ویدیو را برای مقیاس‌بندی یا تغییر اندازه از طریق URL ارائه کنید؛ ارتفاع و عرض باید هر دو با ابعاد زوج باشند تا الزامات کدک ویدیو رعایت شود.

پیشرفته mode · pad_color · codec · preset · width · height · crf
mode پیش‌فرض stretch

روش تغییر اندازه: `stretch` ابعاد درخواستی را تحمیل می‌کند و ممکن است نسبت تصویر را تغییر دهد. `pad` و `crop` هر دو نسبت تصویر را حفظ می‌کنند: `pad` ویدیو را در ابعاد درخواستی جا می‌دهد و فضای خالی را با رنگ انتخاب‌شده پر می‌کند (letterboxing/pillarboxing). `crop` ابعاد درخواستی را پر می‌کند و سپس برای رسیدن به اندازه دقیق، از مرکز برش می‌دهد.

pad_color پیش‌فرض black

رنگ padding در حالت `pad`؛ حالت‌های دیگر آن را نادیده می‌گیرند.

codec پیش‌فرض libx264

کدک رمزگذاری را انتخاب کنید: برای فشرده‌سازی بهتر از libx265 (H.265/HEVC) و برای سازگاری گسترده از libx264 (H.264) استفاده کنید.

preset پیش‌فرض fast

پیش‌تنظیم کنترل‌کننده سرعت رمزگذاری. انتخاب پیش‌تنظیم کندتر فشرده‌سازی را بهبود می‌دهد اما زمان رمزگذاری را افزایش می‌دهد.

عرض خروجی برحسب پیکسل، قابل استفاده به‌تنهایی یا همراه ارتفاع؛ ارائه حداقل یکی از ابعاد الزامی است. اگر فقط عرض ارائه شود، ارتفاع بدون تغییر نسبت تصویر خودکار محاسبه می‌شود.

ارتفاع خروجی برحسب پیکسل، قابل استفاده به‌تنهایی یا همراه عرض؛ ارائه حداقل یکی از ابعاد الزامی است. اگر فقط ارتفاع ارائه شود، عرض بدون تغییر نسبت تصویر خودکار محاسبه می‌شود.

پیش‌فرض 18

Constant Rate Factor کنترل‌کننده کیفیت در بازه 0–51؛ مقدار 18 برای بیشتر محتواها معمولاً بدون افت کیفیت به نظر می‌رسد. کاهش مقدار کیفیت را بهتر اما اندازه فایل را بزرگ‌تر می‌کند.

POST /run/workflow-utilities/scale-video?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/workflow-utilities/scale-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

درباره Workflow Utilities Scale Video

اندازهٔ ویدیو را به `width` هدف (حداکثر 7680) و/یا `height` (حداکثر 4320) تغییر می‌دهد؛ اگر فقط یکی ارائه شود، دیگری از نسبت تصویر پیروی می‌کند. `mode` می‌تواند stretch، pad (با رنگ انتخابی) یا crop باشد. با libx264 یا libx265، پیش‌تنظیم سرعتی از ultrafast تا slow و `crf` از 0 تا 51 کدگذاری می‌کند. ابعاد اصلی و جدید را برمی‌گرداند.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
video_urlالزامی video
نوعurl · video
ویدیو را برای مقیاس‌بندی یا تغییر اندازه از طریق URL ارائه کنید؛ ارتفاع و عرض باید هر دو با ابعاد زوج باشند تا الزامات کدک ویدیو رعایت شود.
widthاختیاری
نوعinteger | null
۲ – ۷٬۶۸۰
عرض خروجی برحسب پیکسل، قابل استفاده به‌تنهایی یا همراه ارتفاع؛ ارائه حداقل یکی از ابعاد الزامی است. اگر فقط عرض ارائه شود، ارتفاع بدون تغییر نسبت تصویر خودکار محاسبه می‌شود.
heightاختیاری
نوعinteger | null
۲ – ۴٬۳۲۰
ارتفاع خروجی برحسب پیکسل، قابل استفاده به‌تنهایی یا همراه عرض؛ ارائه حداقل یکی از ابعاد الزامی است. اگر فقط ارتفاع ارائه شود، عرض بدون تغییر نسبت تصویر خودکار محاسبه می‌شود.
modeاختیاری
نوعenum
پیش‌فرضstretch
stretchpadcrop
روش تغییر اندازه: `stretch` ابعاد درخواستی را تحمیل می‌کند و ممکن است نسبت تصویر را تغییر دهد. `pad` و `crop` هر دو نسبت تصویر را حفظ می‌کنند: `pad` ویدیو را در ابعاد درخواستی جا می‌دهد و فضای خالی را با رنگ انتخاب‌شده پر می‌کند (letterboxing/pillarboxing). `crop` ابعاد درخواستی را پر می‌کند و سپس برای رسیدن به اندازه دقیق، از مرکز برش می‌دهد.
pad_colorاختیاری
نوعenum
پیش‌فرضblack
blackwhiteredgreenbluegray
رنگ padding در حالت `pad`؛ حالت‌های دیگر آن را نادیده می‌گیرند.
codecاختیاری
نوعenum
پیش‌فرضlibx264
libx264libx265
کدک رمزگذاری را انتخاب کنید: برای فشرده‌سازی بهتر از libx265 (H.265/HEVC) و برای سازگاری گسترده از libx264 (H.264) استفاده کنید.
presetاختیاری
نوعenum
پیش‌فرضfast
ultrafastfastmediumslow
پیش‌تنظیم کنترل‌کننده سرعت رمزگذاری. انتخاب پیش‌تنظیم کندتر فشرده‌سازی را بهبود می‌دهد اما زمان رمزگذاری را افزایش می‌دهد.
crfاختیاری
نوعinteger
پیش‌فرض18
۰ – ۵۱
Constant Rate Factor کنترل‌کننده کیفیت در بازه 0–51؛ مقدار 18 برای بیشتر محتواها معمولاً بدون افت کیفیت به نظر می‌رسد. کاهش مقدار کیفیت را بهتر اما اندازه فایل را بزرگ‌تر می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/scale-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": 3600,
    "usd": "3.60",
    "charged": 3600,
    "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
    },
    "original_width": 1929,
    "original_height": 1082,
    "scaled_width": 1920,
    "scaled_height": 1080
  },
  "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}ویدیو پس از مقیاس‌بندی یا تغییر اندازه.
original_width
integerعرض ویدیوی اصلی، برحسب پیکسل.
original_height
integerارتفاع ویدیوی اصلی، برحسب پیکسل.
scaled_width
integerعرض ویدیوی خروجی، برحسب پیکسل.
scaled_height
integerارتفاع ویدیوی خروجی، برحسب پیکسل.

مدل‌های بیشتر: ویدیو به ویدیو

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