Vydra

Plugin Vydra đi kèm bổ sung:

• Tạo hình ảnh qua vydra/grok-imagine
• Tạo video qua vydra/veo3 (văn bản thành video) và vydra/kling (hình ảnh thành video)
• Tổng hợp giọng nói qua tuyến TTS của Vydra sử dụng ElevenLabs

OpenClaw sử dụng cùng một VYDRA_API_KEY cho cả ba khả năng.

Thuộc tính	Giá trị
ID nhà cung cấp	vydra
Plugin	đi kèm, enabledByDefault: true
Biến môi trường xác thực	VYDRA_API_KEY
Cờ thiết lập ban đầu	--auth-choice vydra-api-key
Cờ CLI trực tiếp	--vydra-api-key <key>
Hợp đồng	imageGenerationProviders, videoGenerationProviders, speechProviders
URL cơ sở	https://www.vydra.ai/api/v1 (sử dụng máy chủ www)

Sử dụng https://www.vydra.ai/api/v1 làm URL cơ sở. Máy chủ miền gốc của Vydra (https://vydra.ai/api/v1) hiện chuyển hướng đến www. Một số trình khách HTTP loại bỏ Authorization khi chuyển hướng giữa các máy chủ, khiến khóa API hợp lệ bị báo lỗi xác thực gây hiểu nhầm. Plugin đi kèm chuẩn hóa mọi URL cơ sở vydra.ai đã cấu hình thành www.vydra.ai để tránh sự cố này.

​

Thiết lập

1. Chạy quy trình thiết lập ban đầu tương tác

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

   Hoặc đặt trực tiếp biến môi trường:

   export VYDRA_API_KEY="vydra_live_..."
   
2. Chọn một khả năng mặc định

   Chọn một hoặc nhiều khả năng bên dưới (hình ảnh, video hoặc giọng nói) và áp dụng cấu hình tương ứng.

​

Khả năng

Tạo hình ảnh

Mô hình hình ảnh mặc định và duy nhất đi kèm:

• vydra/grok-imagine

Đặt mô hình này làm nhà cung cấp hình ảnh mặc định:

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

Hỗ trợ đi kèm chỉ chuyển văn bản thành hình ảnh, tối đa một hình ảnh cho mỗi yêu cầu. Các tuyến chỉnh sửa được Vydra lưu trữ yêu cầu URL hình ảnh từ xa và Plugin đi kèm không bổ sung cầu nối tải lên dành riêng cho Vydra.

Xem Tạo hình ảnh để biết các tham số công cụ dùng chung, cách chọn nhà cung cấp và hành vi chuyển đổi dự phòng.

Tạo video

Các mô hình video đã đăng ký:

• vydra/veo3 để chuyển văn bản thành video (từ chối đầu vào tham chiếu hình ảnh)
• vydra/kling để chuyển hình ảnh thành video (yêu cầu chính xác một URL hình ảnh từ xa)

Đặt Vydra làm nhà cung cấp video mặc định:

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

Lưu ý:

• vydra/kling từ chối ngay từ đầu việc tải tệp cục bộ lên; chỉ tham chiếu URL hình ảnh từ xa mới hoạt động.
• Tuyến HTTP kling của Vydra chưa nhất quán về việc yêu cầu image_url hay video_url; nhà cung cấp đi kèm gửi cùng một URL hình ảnh từ xa trong cả hai trường.
• Plugin đi kèm duy trì cách tiếp cận thận trọng và không chuyển tiếp các tùy chọn kiểu chưa được lập tài liệu như tỷ lệ khung hình, độ phân giải, hình mờ hoặc âm thanh được tạo.

Xem Tạo video để biết các tham số công cụ dùng chung, cách chọn nhà cung cấp và hành vi chuyển đổi dự phòng.

Kiểm thử trực tiếp video

Phạm vi kiểm thử trực tiếp dành riêng cho nhà cung cấp:

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

Tệp kiểm thử trực tiếp Vydra đi kèm bao quát:

• vydra/veo3 chuyển văn bản thành video
• vydra/kling chuyển hình ảnh thành video bằng URL hình ảnh từ xa

Ghi đè dữ liệu mẫu hình ảnh từ xa khi cần:

export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"

Tổng hợp giọng nói

Đặt Vydra làm nhà cung cấp giọng nói:

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

Giá trị mặc định:

• Mô hình: elevenlabs/tts
• ID giọng nói: 21m00Tcm4TlvDq8ikWAM (“Rachel”)

Plugin đi kèm cung cấp một giọng nói mặc định đã được xác nhận hoạt động tốt này và trả về các tệp âm thanh MP3.

​

Liên quan

Danh mục nhà cung cấp

Duyệt qua tất cả nhà cung cấp hiện có.

Tạo hình ảnh

Các tham số công cụ hình ảnh dùng chung và cách chọn nhà cung cấp.

Tạo video

Các tham số công cụ video dùng chung và cách chọn nhà cung cấp.

Tài liệu tham chiếu cấu hình

Giá trị mặc định của tác tử và cấu hình mô hình.