Vydra

تضيف Plugin ‏Vydra المضمّنة ما يلي:

إنشاء الصور عبر vydra/grok-imagine
إنشاء الفيديو عبر vydra/veo3 (من النص إلى الفيديو) وvydra/kling (من الصورة إلى الفيديو)
تركيب الكلام عبر مسار تحويل النص إلى كلام في Vydra والمدعوم من ElevenLabs

يستخدم 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`)

استخدم https://www.vydra.ai/api/v1 بوصفه عنوان URL الأساسي. يعيد المضيف الجذري لـ Vydra ‏(https://vydra.ai/api/v1) حاليًا التوجيه إلى www. تحذف بعض عملاء HTTP ترويسة Authorization عند إعادة التوجيه بين مضيفين مختلفين، ما يحوّل مفتاح API صالحًا إلى فشل مصادقة مضلل. تطبّع Plugin المضمّنة أي عنوان URL أساسي مضبوط على vydra.ai إلى www.vydra.ai لتجنب ذلك.

الإعداد

تشغيل الإعداد الأولي التفاعلي

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 لصور بعيدة، ولا تضيف Plugin المضمّنة جسر رفع خاصًا بـ Vydra.

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

إنشاء الفيديو

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

vydra/veo3 لإنشاء الفيديو من النص (يرفض مدخلات مراجع الصور)
vydra/kling لإنشاء الفيديو من الصورة (يتطلب عنوان URL واحدًا بالضبط لصورة بعيدة)

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

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "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 (“Rachel”)

تعرض Plugin المضمّنة هذا الصوت الافتراضي الوحيد المعروف بسلامة عمله، وتعيد ملفات صوتية بتنسيق MP3.

ذو صلة

دليل المزوّدين

تصفّح جميع المزوّدين المتاحين.

إنشاء الصور

معاملات أداة الصور المشتركة واختيار المزوّد.

إنشاء الفيديو

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

مرجع الإعداد

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

Overview

Concepts and configuration

Providers

الإعداد

الإمكانات

ذو صلة

دليل المزوّدين

إنشاء الصور

إنشاء الفيديو

مرجع الإعداد

​الإعداد

​الإمكانات

​ذو صلة

دليل المزوّدين

إنشاء الصور

إنشاء الفيديو

مرجع الإعداد

الإعداد

الإمكانات

ذو صلة