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-provider
openclaw 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`

لم يُتح توليد قوالب الصور في PixVerse عبر image_generate حتى الآن. تعتمد API هذه على معرّف القالب، بينما لا يتضمن عقد توليد الصور المشترك في OpenClaw حاليًا مجموعة خيارات مكتوبة خاصة بـ PixVerse.

خيارات الموفّر

يقبل موفّر الفيديو المفاتيح الاختيارية التالية الخاصة بالموفّر:

الخيار	النوع	التأثير
`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).

ذو صلة

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

معلمات الأداة المشتركة واختيار الموفّر والسلوك غير المتزامن.

مرجع الإعداد

الإعدادات الافتراضية للوكيل، بما في ذلك نموذج توليد الفيديو.

Overview

Concepts and configuration

Providers

بدء الاستخدام

الأوضاع والنماذج المدعومة

خيارات الموفّر

الإعداد

الإعداد المتقدم

ذو صلة

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

مرجع الإعداد

​بدء الاستخدام

​الأوضاع والنماذج المدعومة

​خيارات الموفّر

​الإعداد

​الإعداد المتقدم

​ذو صلة

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

مرجع الإعداد

بدء الاستخدام

الأوضاع والنماذج المدعومة

خيارات الموفّر

الإعداد

الإعداد المتقدم

ذو صلة