توليد الفيديو

تحدد إدخالات المراجع وضع وقت التشغيل:

• لا توجد وسائط مرجعية → generate
• أي مرجع صورة → imageToVideo
• أي مرجع فيديو → videoToVideo
• إدخالات الصوت المرجعية لا تغيّر الوضع المحسوم؛ فهي تُطبَّق فوق أي وضع تختاره مراجع الصورة/الفيديو، ولا تعمل إلا مع المزوّدات التي تعلن maxInputAudios.

لا تُعد مراجع الصور والفيديو المختلطة سطح قدرات مشتركة مستقرًا. فضّل نوع مرجع واحدًا لكل طلب.

# الرجوع الاحتياطي والخيارات المكتوبة

تُطبَّق بعض فحوصات القدرات في طبقة الرجوع الاحتياطي بدلًا من حدود الأداة، لذلك يمكن لطلب يتجاوز حدود المزوّد الأساسي أن يعمل رغم ذلك على مزوّد احتياطي قادر:

• يُتخطى المرشح النشط الذي لا يعلن maxInputAudios (أو يعلن 0) عندما يحتوي الطلب على مراجع صوتية؛ ثم يُجرَّب المرشح التالي.
• maxDurationSeconds لدى المرشح النشط أقل من durationSeconds المطلوبة مع عدم وجود قائمة supportedDurationSeconds معلنة → يُتخطى.
• يحتوي الطلب على providerOptions ويعلن المرشح النشط صراحة مخطط providerOptions مكتوبًا → يُتخطى إذا كانت المفاتيح المقدمة غير موجودة في المخطط أو إذا لم تتطابق أنواع القيم. تتلقى المزوّدات التي لا تعلن مخططًا الخيارات كما هي (تمرير متوافق مع الإصدارات السابقة). يمكن للمزوّد إلغاء كل خيارات المزوّد بإعلان مخطط فارغ (capabilities.providerOptions: {})، مما يتسبب في التخطي نفسه كما في حالة عدم تطابق النوع.

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

# الإجراءات

# اختيار النموذج

يحسم OpenClaw النموذج بهذا الترتيب:

1. معلمة الأداة model - إذا حدد الوكيل واحدة في الاستدعاء.
2. videoGenerationModel.primary من الإعدادات.
3. videoGenerationModel.fallbacks بالترتيب.
4. الاكتشاف التلقائي - المزوّدات التي لديها مصادقة صالحة، بدءًا من المزوّد الافتراضي الحالي، ثم بقية المزوّدات بالترتيب الأبجدي.

إذا فشل مزوّد، يُجرَّب المرشح التالي تلقائيًا. إذا فشل جميع المرشحين، يتضمن الخطأ تفاصيل من كل محاولة.

اضبط agents.defaults.mediaGenerationAutoProviderFallback: false لاستخدام إدخالات model وprimary وfallbacks الصريحة فقط.

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],
      },
    },
  },
}

# ملاحظات المزوّدين

# أوضاع قدرات المزوّد

يدعم عقد توليد الفيديو المشترك قدرات خاصة بالأوضاع بدلًا من حدود إجمالية مسطحة فقط. ينبغي لتطبيقات المزوّدين الجديدة تفضيل كتل أوضاع صريحة:

capabilities: {
  generate: {
    maxVideos: 1,
    maxDurationSeconds: 10,
    supportsResolution: true,
  },
  imageToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputImages: 1,
    maxInputImagesByModel: { "provider/reference-to-video": 9 },
    maxDurationSeconds: 5,
  },
  videoToVideo: {
    enabled: true,
    maxVideos: 1,
    maxInputVideos: 1,
    maxDurationSeconds: 5,
  },
}

الحقول الإجمالية المسطحة مثل maxInputImages وmaxInputVideos ليست كافية للإعلان عن دعم وضع التحويل. ينبغي للمزوّدين التصريح بـ generate و imageToVideo وvideoToVideo صراحة حتى تتمكن الاختبارات الحية واختبارات العقد وأداة video_generate المشتركة من التحقق من دعم الوضع بشكل حتمي.

عندما يكون نموذج واحد لدى مزوّد ما ذا دعم أوسع لمدخلات المراجع من البقية، استخدم maxInputImagesByModel أو maxInputVideosByModel أو maxInputAudiosByModel بدلًا من رفع الحد على مستوى الوضع.

# الاختبارات الحية

تغطية حية اختيارية للمزوّدين المضمّنين المشتركين:

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

غلاف المستودع:

pnpm test:live:media video

يحمّل هذا الملف الحي متغيرات بيئة المزوّدين الناقصة من ~/.profile، ويفضّل افتراضيًا مفاتيح واجهة برمجة التطبيقات الحية/البيئية على ملفات تعريف المصادقة المخزنة، ويشغّل افتراضيًا اختبار دخان آمنًا للإصدار:

• generate لكل مزوّد غير FAL في المسح.
• موجه جراد بحر مدته ثانية واحدة.
• حد عمليات لكل مزوّد من OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (180000 افتراضيًا).

FAL اختياري لأن زمن انتظار الطابور من جهة المزوّد قد يهيمن على وقت الإصدار:

pnpm test:live:media video --video-providers fal

اضبط OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 لتشغيل أوضاع التحويل المعلنة أيضًا التي يستطيع المسح المشترك تمرينها بأمان باستخدام وسائط محلية:

• imageToVideo عندما تكون capabilities.imageToVideo.enabled.
• videoToVideo عندما تكون capabilities.videoToVideo.enabled ويقبل المزوّد/النموذج إدخال فيديو محليًا مدعومًا بمخزن مؤقت في المسح المشترك.

اليوم يغطي مسار videoToVideo الحي المشترك runway فقط عندما تختار runway/gen4_aleph.

# التكوين

اضبط نموذج توليد الفيديو الافتراضي في تكوين OpenClaw لديك:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-r2v-flash"],
      },
    },
  },
}

أو عبر CLI:

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

# ذات صلة

• Alibaba Model Studio
• المهام الخلفية - تتبع المهام لتوليد الفيديو غير المتزامن
• BytePlus
• ComfyUI
• مرجع التكوين
• fal
• Google (Gemini)
• MiniMax
• النماذج
• OpenAI
• Qwen
• Runway
• Together AI
• نظرة عامة على الأدوات
• Vydra
• xAI