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

Workflow Utilities Extract Nth Frame

التكامل

معرّف النموذج workflow-utilities/extract-nth-frame
# 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/extract-nth-frame?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"

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

الحصول على مفتاح API
Utility · صورة

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

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

إنشاء طلب

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

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

عنوان URL للفيديو المصدر المستخدم لاستخراج الإطارات.

متقدم output_format · frame_interval · max_frames · quality
output_format الافتراضي png

تنسيق الملف المستخدم للإطارات المستخرجة.

الافتراضي 12

فاصل استخراج الإطارات: اختر كل إطار رقم N. مثلًا، يختار 3 كل إطار ثالث، ويختار 12 كل إطار ثاني عشر.

الافتراضي 100

الحد الأقصى لعدد الإطارات المستخرجة.

الافتراضي 95

جودة المخرج لـ jpg/webp، من 1 إلى 100.

POST /run/workflow-utilities/extract-nth-frame?wait=20 عرض السعر → ⁨‏0.90 $⁩
# 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/extract-nth-frame?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 Extract Nth Frame

يستخرج إطارات ثابتة من فيديو على فواصل منتظمة. يحدد `frame_interval` استخراج كل إطار رقم N (من 1 إلى 300)، ويحد `max_frames` العدد (من 1 إلى 500)، ويمكن أن تكون الصيغة png أو jpg أو jpeg أو webp. تنطبق `quality` (من 1 إلى 100) على jpg وwebp. والنتيجة مصفوفة من الصور مع عدد الإطارات.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL للفيديو المصدر المستخدم لاستخراج الإطارات.
frame_intervalاختياري
النوعinteger
الافتراضي12
1 – 300
فاصل استخراج الإطارات: اختر كل إطار رقم N. مثلًا، يختار 3 كل إطار ثالث، ويختار 12 كل إطار ثاني عشر.
output_formatاختياري
النوعenum
الافتراضيpng
pngjpgjpegwebp
تنسيق الملف المستخدم للإطارات المستخرجة.
max_framesاختياري
النوعinteger
الافتراضي100
1 – 500
الحد الأقصى لعدد الإطارات المستخرجة.
qualityاختياري
النوعinteger
الافتراضي95
1 – 100
جودة المخرج لـ jpg/webp، من 1 إلى 100.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "workflow-utilities/extract-nth-frame",
  "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": 900,
    "usd": "0.90",
    "charged": 900,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "frame_count": 25
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}مصفوفة تحتوي على صور الإطارات المستخرجة.
frame_count
integerإجمالي عدد الإطارات المستخرجة.

مزيد من النماذج: تحرير الصور

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