Providers

Vydra

يضيف Plugin المضمّن Vydra ما يلي:

  • توليد الصور عبر vydra/grok-imagine
  • توليد الفيديو عبر vydra/veo3 وvydra/kling
  • تركيب الكلام عبر مسار TTS المدعوم من ElevenLabs في Vydra

يستخدم OpenClaw المفتاح نفسه VYDRA_API_KEY للإمكانات الثلاث جميعها.

الخاصية القيمة
معرّف المزوّد vydra
Plugin مضمّن، enabledByDefault: true
متغير بيئة المصادقة VYDRA_API_KEY
علم التهيئة الأولية --auth-choice vydra-api-key
علم CLI المباشر --vydra-api-key <key>
العقود imageGenerationProviders, videoGenerationProviders, speechProviders
عنوان URL الأساسي https://www.vydra.ai/api/v1 (استخدم مضيف www)

الإعداد

  • تشغيل التهيئة الأولية التفاعلية

    openclaw onboard --auth-choice vydra-api-key
    

    أو عيّن متغير البيئة مباشرة:

    export VYDRA_API_KEY="vydra_live_..."
    
  • اختيار إمكانية افتراضية

    اختر واحدة أو أكثر من الإمكانات أدناه (الصورة أو الفيديو أو الكلام) وطبّق الإعداد المطابق.

  • الإمكانات

    توليد الصور

    نموذج الصور الافتراضي:

    • vydra/grok-imagine

    عيّنه كمزوّد الصور الافتراضي:

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "vydra/grok-imagine",
          },
        },
      },
    }
    

    يقتصر الدعم المضمّن الحالي على تحويل النص إلى صورة فقط. تتوقع مسارات التحرير المستضافة لدى Vydra عناوين URL بعيدة للصور، ولا يضيف OpenClaw حتى الآن جسر رفع خاصًا بـ Vydra في Plugin المضمّن.

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

    نماذج الفيديو المسجلة:

    • vydra/veo3 لتحويل النص إلى فيديو
    • vydra/kling لتحويل الصورة إلى فيديو

    عيّن Vydra كمزوّد الفيديو الافتراضي:

    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "vydra/veo3",
          },
        },
      },
    }
    

    ملاحظات:

    • يتم تضمين vydra/veo3 كتحويل من نص إلى فيديو فقط.
    • يتطلب vydra/kling حاليًا مرجع عنوان URL بعيدًا لصورة. تُرفض عمليات رفع الملفات المحلية مسبقًا.
    • كان مسار HTTP الحالي kling في Vydra غير متسق بشأن ما إذا كان يتطلب image_url أو video_url؛ يربط المزوّد المضمّن عنوان URL البعيد نفسه للصورة بكلا الحقلين.
    • يبقى Plugin المضمّن محافظًا ولا يمرر عناصر تحكم غير موثقة في النمط مثل نسبة العرض إلى الارتفاع أو الدقة أو العلامة المائية أو الصوت المولّد.
    اختبارات الفيديو الحية

    تغطية حية خاصة بالمزوّد:

    OPENCLAW_LIVE_TEST=1 \
    OPENCLAW_LIVE_VYDRA_VIDEO=1 \
    pnpm test:live -- extensions/vydra/vydra.live.test.ts
    

    يغطي ملف Vydra الحي المضمّن الآن:

    • تحويل النص إلى فيديو عبر vydra/veo3
    • تحويل الصورة إلى فيديو عبر vydra/kling باستخدام عنوان URL بعيد لصورة

    تجاوز مُثبّت الصورة البعيد عند الحاجة:

    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    
    تركيب الكلام

    عيّن Vydra كمزوّد الكلام:

    {
      messages: {
        tts: {
          provider: "vydra",
          providers: {
            vydra: {
              apiKey: "${VYDRA_API_KEY}",
              voiceId: "21m00Tcm4TlvDq8ikWAM",
            },
          },
        },
      },
    }
    

    الإعدادات الافتراضية:

    • النموذج: elevenlabs/tts
    • معرّف الصوت: 21m00Tcm4TlvDq8ikWAM

    يعرِض Plugin المضمّن حاليًا صوتًا افتراضيًا واحدًا معروفًا بجودته، ويعيد ملفات صوتية بصيغة MP3.

    ذو صلة