OpenClawDocs
في هذه الصفحة

في هذه الصفحة

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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

    bash
    openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restart

  • عيّن مفتاح API

    bash
    openclaw onboard --auth-choice pixverse-api-key

    يطالبك المعالج باختيار نقطة النهاية الدولية أو الصينية (راجع منطقة API أدناه) قبل كتابة region وbaseUrl في إعدادات الموفّر. تستخدم عمليات التشغيل غير التفاعلية (عند أخذ المفتاح من --pixverse-api-key أو PIXVERSE_API_KEY) المنطقة الدولية افتراضيًا.

    يعيّن الإعداد الأولي أيضًا agents.defaults.videoGenerationModel.primary إلى pixverse/v6 إذا لم يكن هناك نموذج فيديو افتراضي مُعدّ بعد.

  • بدّل موفّر الفيديو الافتراضي الحالي (اختياري)

    bash
    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 المُفعّل

    الإعداد

    json5
    {  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 لاختيار منطقة في معالج الإعداد:

    json5
    {  models: {    providers: {      pixverse: {        region: "cn", // "international" أو "cn"        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",        models: [],      },    },  },}
    عنوان URL أساسي مخصص

    عيّن models.providers.pixverse.baseUrl فقط عند التوجيه عبر وكيل متوافق وموثوق. تكون لـ baseUrl الأولوية على region.

    json5
    {  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).

    ذو صلة

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

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

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