Langsung ke konten utama

Vydra

Plugin Vydra bawaan menambahkan:
  • pembuatan gambar melalui vydra/grok-imagine
  • pembuatan video melalui vydra/veo3 dan vydra/kling
  • sintesis speech melalui rute TTS Vydra yang didukung ElevenLabs
OpenClaw menggunakan VYDRA_API_KEY yang sama untuk ketiga kapabilitas tersebut.

URL dasar penting

Gunakan https://www.vydra.ai/api/v1. Host apex Vydra (https://vydra.ai/api/v1) saat ini mengalihkan ke www. Beberapa klien HTTP menghapus Authorization pada pengalihan lintas host tersebut, yang membuat API key yang valid tampak seperti kegagalan auth yang menyesatkan. Plugin bawaan menggunakan URL dasar www secara langsung untuk menghindari hal itu.

Penyiapan

Onboarding interaktif:
openclaw onboard --auth-choice vydra-api-key
Atau set env var secara langsung:
export VYDRA_API_KEY="vydra_live_..."

Pembuatan gambar

Model gambar default:
  • vydra/grok-imagine
Set sebagai penyedia gambar default:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "vydra/grok-imagine",
      },
    },
  },
}
Dukungan bawaan saat ini hanya untuk text-to-image. Rute edit yang dihosting Vydra mengharapkan URL gambar jarak jauh, dan OpenClaw belum menambahkan bridge upload khusus Vydra di plugin bawaan. Lihat Image Generation untuk perilaku alat bersama.

Pembuatan video

Model video yang terdaftar:
  • vydra/veo3 untuk text-to-video
  • vydra/kling untuk image-to-video
Set Vydra sebagai penyedia video default:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "vydra/veo3",
      },
    },
  },
}
Catatan:
  • vydra/veo3 dibundel hanya sebagai text-to-video.
  • vydra/kling saat ini memerlukan referensi URL gambar jarak jauh. Upload file lokal ditolak di awal.
  • Rute HTTP kling Vydra saat ini tidak konsisten mengenai apakah memerlukan image_url atau video_url; penyedia bawaan memetakan URL gambar jarak jauh yang sama ke kedua field tersebut.
  • Plugin bawaan tetap konservatif dan tidak meneruskan knob style yang tidak terdokumentasi seperti aspect ratio, resolution, watermark, atau audio yang dihasilkan.
Cakupan live khusus penyedia:
OPENCLAW_LIVE_TEST=1 \
OPENCLAW_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
File live Vydra bawaan sekarang mencakup:
  • vydra/veo3 text-to-video
  • vydra/kling image-to-video menggunakan URL gambar jarak jauh
Override fixture gambar jarak jauh bila diperlukan:
export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
Lihat Video Generation untuk perilaku alat bersama.

Sintesis speech

Set Vydra sebagai penyedia speech:
{
  messages: {
    tts: {
      provider: "vydra",
      providers: {
        vydra: {
          apiKey: "${VYDRA_API_KEY}",
          voiceId: "21m00Tcm4TlvDq8ikWAM",
        },
      },
    },
  },
}
Default:
  • model: elevenlabs/tts
  • id suara: 21m00Tcm4TlvDq8ikWAM
Plugin bawaan saat ini mengekspos satu suara default yang sudah teruji baik dan mengembalikan file audio MP3.

Terkait