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

Providers

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)

Thiết lập

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

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

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

    bash
    export VYDRA_API_KEY="vydra_live_..."

  • 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:

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

    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:

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

    bash
    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:

    bash
    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:

    json5
    {  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.
    Was this useful?
    On this page

    On this page