> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`)                     |

<Warning>
  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.
</Warning>

## Thiết lập

<Steps>
  <Step title="Chạy quy trình thiết lập ban đầu tương tác">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice vydra-api-key
    ```

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

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export VYDRA_API_KEY="vydra_live_..."
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Khả năng

<AccordionGroup>
  <Accordion title="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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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.

    <Note>
      Xem [Tạo hình ảnh](/vi/tools/image-generation) để 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.
    </Note>
  </Accordion>

  <Accordion title="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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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.

    <Note>
      Xem [Tạo video](/vi/tools/video-generation) để 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.
    </Note>
  </Accordion>

  <Accordion title="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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    ```
  </Accordion>

  <Accordion title="Tổng hợp giọng nói">
    Đặt Vydra làm nhà cung cấp giọng nói:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      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.
  </Accordion>
</AccordionGroup>

## Liên quan

<CardGroup cols={2}>
  <Card title="Danh mục nhà cung cấp" href="/vi/providers/index" icon="list">
    Duyệt qua tất cả nhà cung cấp hiện có.
  </Card>

  <Card title="Tạo hình ảnh" href="/vi/tools/image-generation" icon="image">
    Các tham số công cụ hình ảnh dùng chung và cách chọn nhà cung cấp.
  </Card>

  <Card title="Tạo video" href="/vi/tools/video-generation" icon="video">
    Các tham số công cụ video dùng chung và cách chọn nhà cung cấp.
  </Card>

  <Card title="Tài liệu tham chiếu cấu hình" href="/vi/gateway/config-agents#agent-defaults" icon="gear">
    Giá trị mặc định của tác tử và cấu hình mô hình.
  </Card>
</CardGroup>