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

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"

حتى ⁨‏3.60 $⁩ لكل تشغيل تُحتسب التكلفة حسب الاستخدام الفعلي، ويُسترد الباقي تشغيله في هذه الصفحة

الحصول على مفتاح API
Utility · فيديو

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

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

إنشاء طلب

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

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

وفّر الفيديو المطلوب تحجيمه أو تغيير حجمه عبر عنوان URL، باستخدام أبعاد زوجية للارتفاع والعرض لتلبية متطلبات برنامج ترميز الفيديو.

متقدم mode · pad_color · codec · preset · width · height · crf
mode الافتراضي stretch

طريقة تغيير الحجم: تفرض `stretch` الأبعاد المطلوبة وقد تغيّر نسبة العرض إلى الارتفاع. تحافظ `pad` و`crop` على النسبة: تُلائم `pad` الفيديو داخل الأبعاد المطلوبة وتملأ المساحة غير المستخدمة باللون المحدد، بينما تملأ `crop` الأبعاد المطلوبة ثم تقص مركزيًا لمطابقة الحجم الدقيق.

pad_color الافتراضي black

اللون المستخدم للحشو في وضع `pad`؛ تتجاهله الأوضاع الأخرى.

codec الافتراضي libx264

اختر برنامج ترميز: استخدم libx265 (H.265/HEVC) لضغط أفضل، أو libx264 (H.264) لتوافق واسع.

preset الافتراضي fast

إعداد مسبق يتحكم في سرعة الترميز. يحسن اختيار إعداد أبطأ الضغط، لكنه يزيد زمن الترميز.

عرض المخرج بالبكسل، ويمكن استخدامه منفردًا أو مع الارتفاع؛ يلزم تحديد بُعد واحد على الأقل. عند تحديد العرض فقط، يُشتق الارتفاع تلقائيًا دون تغيير نسبة العرض إلى الارتفاع.

ارتفاع المخرج بالبكسل، ويمكن استخدامه منفردًا أو مع العرض؛ يلزم تحديد بُعد واحد على الأقل. عند تحديد الارتفاع فقط، يُشتق العرض تلقائيًا دون تغيير نسبة العرض إلى الارتفاع.

الافتراضي 18

عامل معدل ثابت يتحكم في الجودة ضمن النطاق 0–51، حيث تبدو القيمة 18 عادةً بلا فقد لمعظم المحتوى. يحسن خفض الإعداد الجودة، لكنه يزيد حجم الملف.

POST /run/workflow-utilities/scale-video?wait=20 عرض السعر → ⁨‏3.60 $⁩
# 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
2 – 7,680
عرض المخرج بالبكسل، ويمكن استخدامه منفردًا أو مع الارتفاع؛ يلزم تحديد بُعد واحد على الأقل. عند تحديد العرض فقط، يُشتق الارتفاع تلقائيًا دون تغيير نسبة العرض إلى الارتفاع.
heightاختياري
النوعinteger | null
2 – 4,320
ارتفاع المخرج بالبكسل، ويمكن استخدامه منفردًا أو مع العرض؛ يلزم تحديد بُعد واحد على الأقل. عند تحديد الارتفاع فقط، يُشتق العرض تلقائيًا دون تغيير نسبة العرض إلى الارتفاع.
modeاختياري
النوعenum
الافتراضيstretch
stretchpadcrop
طريقة تغيير الحجم: تفرض `stretch` الأبعاد المطلوبة وقد تغيّر نسبة العرض إلى الارتفاع. تحافظ `pad` و`crop` على النسبة: تُلائم `pad` الفيديو داخل الأبعاد المطلوبة وتملأ المساحة غير المستخدمة باللون المحدد، بينما تملأ `crop` الأبعاد المطلوبة ثم تقص مركزيًا لمطابقة الحجم الدقيق.
pad_colorاختياري
النوعenum
الافتراضيblack
blackwhiteredgreenbluegray
اللون المستخدم للحشو في وضع `pad`؛ تتجاهله الأوضاع الأخرى.
codecاختياري
النوعenum
الافتراضيlibx264
libx264libx265
اختر برنامج ترميز: استخدم libx265 (H.265/HEVC) لضغط أفضل، أو libx264 (H.264) لتوافق واسع.
presetاختياري
النوعenum
الافتراضيfast
ultrafastfastmediumslow
إعداد مسبق يتحكم في سرعة الترميز. يحسن اختيار إعداد أبطأ الضغط، لكنه يزيد زمن الترميز.
crfاختياري
النوعinteger
الافتراضي18
0 – 51
عامل معدل ثابت يتحكم في الجودة ضمن النطاق 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?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/ar/developers/models/workflow-utilities/scale-video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt