Providers
PixVerse
يوفّر OpenClaw pixverse بوصفه Plugin خارجيًا رسميًا لتوليد فيديوهات PixVerse المستضافة. يسجّل Plugin موفّر pixverse وفق عقد videoGenerationProviders.
| الخاصية | القيمة |
|---|---|
| معرّف الموفّر | pixverse |
| حزمة Plugin | @openclaw/pixverse-provider |
| متغيّر بيئة المصادقة | PIXVERSE_API_KEY |
| خيار الإعداد الأولي | --auth-choice pixverse-api-key |
| خيار CLI المباشر | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (إرسال video_id ثم استطلاع النتيجة) |
| النموذج الافتراضي | pixverse/v6 |
| منطقة API الافتراضية | الدولية |
بدء الاستخدام
ثبّت Plugin
openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restartعيّن مفتاح API
openclaw onboard --auth-choice pixverse-api-keyيطالبك المعالج باختيار نقطة النهاية الدولية أو الصينية (راجع منطقة API
أدناه) قبل كتابة region وbaseUrl في إعدادات الموفّر.
تستخدم عمليات التشغيل غير التفاعلية (عند أخذ المفتاح من --pixverse-api-key أو PIXVERSE_API_KEY)
المنطقة الدولية افتراضيًا.
يعيّن الإعداد الأولي أيضًا agents.defaults.videoGenerationModel.primary إلى
pixverse/v6 إذا لم يكن هناك نموذج فيديو افتراضي مُعدّ بعد.
بدّل موفّر الفيديو الافتراضي الحالي (اختياري)
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"أنشئ فيديو
اطلب من الوكيل إنشاء فيديو. سيُستخدم PixVerse تلقائيًا.
الأوضاع والنماذج المدعومة
يتيح الموفّر نماذج توليد PixVerse من خلال أداة الفيديو المشتركة في OpenClaw.
| الوضع | النماذج | الإدخال المرجعي |
|---|---|---|
| تحويل النص إلى فيديو | v6 (افتراضي)، c1 |
لا يوجد |
| تحويل الصورة إلى فيديو | v6 (افتراضي)، c1 |
صورة محلية أو بعيدة واحدة |
تُرفع مراجع الصور المحلية إلى PixVerse قبل طلب تحويل الصورة إلى فيديو. وتُمرّر عناوين URL للصور البعيدة عبر نقطة نهاية رفع الصور في PixVerse بصيغة image_url.
| الخيار | القيم المدعومة |
|---|---|
| المدة | من ثانية واحدة إلى 15 ثانية (الافتراضي 5) |
| الدقة | 360P، 540P، 720P، 1080P (الافتراضي 540P؛ تُحوّل طلبات 480P إلى 540P) |
| نسبة العرض إلى الارتفاع | 16:9 (افتراضي)، 4:3، 1:1، 3:4، 9:16، 2:3، 3:2، 21:9؛ لتحويل النص إلى فيديو فقط، أما تحويل الصورة إلى فيديو فيتبع الصورة المصدر |
| الصوت المُنشأ | audio: true |
خيارات الموفّر
يقبل موفّر الفيديو المفاتيح الاختيارية التالية الخاصة بالموفّر:
| الخيار | النوع | التأثير |
|---|---|---|
seed |
رقم | قيمة أولية حتمية من 0 إلى 2147483647 |
negativePrompt / negative_prompt |
سلسلة | موجّه سلبي |
quality |
سلسلة | جودة PixVerse مثل 720p |
motionMode / motion_mode |
سلسلة | وضع الحركة لتحويل الصورة إلى فيديو (الافتراضي normal) |
cameraMovement / camera_movement |
سلسلة | إعداد مسبق لحركة كاميرا PixVerse |
templateId / template_id |
رقم | معرّف قالب PixVerse المُفعّل |
الإعداد
{ agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, },}الإعداد المتقدم
منطقة API
| قيمة المنطقة | عنوان URL الأساسي لـ PixVerse API |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
عيّن models.providers.pixverse.region يدويًا عندما ينتمي مفتاحك إلى
منطقة محددة في منصة PixVerse، أو شغّل
openclaw onboard --auth-choice pixverse-api-key لاختيار منطقة في
معالج الإعداد:
{ models: { providers: { pixverse: { region: "cn", // "international" أو "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, },}عنوان URL أساسي مخصص
عيّن models.providers.pixverse.baseUrl فقط عند التوجيه عبر وكيل متوافق وموثوق.
تكون لـ baseUrl الأولوية على region.
{ models: { providers: { pixverse: { baseUrl: "https://app-api.pixverse.ai/openapi/v2", }, }, },}استطلاع المهمة
يعيد PixVerse قيمة video_id من طلب التوليد. يستطلع OpenClaw
المسار /openapi/v2/video/result/{video_id} كل 5 ثوانٍ حتى تنجح المهمة
أو تفشل أو تبلغ المهلة الزمنية (الافتراضي 5 دقائق؛ ويمكن تجاوزها باستخدام
agents.defaults.videoGenerationModel.timeoutMs).
