The official Vydra plugin adds:

Apus uses the same VYDRA_API_KEY for all three capabilities.

Property Value
Provider id vydra
Plugin @openclaw/vydra-provider
Auth env var VYDRA_API_KEY
Onboarding flag --auth-choice vydra-api-key
Direct CLI flag --vydra-api-key <key>
Contracts imageGenerationProviders, videoGenerationProviders, speechProviders
Base URL https://www.vydra.ai/api/v1 (use the www host)

Use https://www.vydra.ai/api/v1 as the base URL. Vydra's apex host (https://vydra.ai/api/v1) currently redirects to www. Some HTTP clients drop Authorization on that cross-host redirect, which turns a valid API key into a misleading auth failure. The bundled plugin normalizes any configured vydra.ai base URL to www.vydra.ai to avoid that.

Setup

Install the plugin

```bash
apus plugins install @openclaw/vydra-provider
```

Installation applies to a running Gateway automatically; otherwise it takes effect
on the next startup. See [Apply changes and inspect](/plugins/manage-plugins#apply-changes-and-inspect).

Run interactive onboarding

```bash
apus onboard --auth-choice vydra-api-key
```

Or set the env var directly:

```bash
export VYDRA_API_KEY="vydra_live_..."
```

Choose a default capability

Pick one or more of the capabilities below (image, video, or speech) and apply the matching configuration.

Capabilities

Image generation 
Default and only Vydra image model:

- `vydra/grok-imagine`

Set it as the default image provider:

```json5
{
  agents: {
    defaults: {
      mediaModels: {
        image: {
          primary: "vydra/grok-imagine",
        },
      },
    },
  },
}
```

Vydra support is text-to-image only, at most one image per request. Vydra's hosted edit routes expect remote image URLs, and the plugin does not add a Vydra-specific upload bridge.

See [Image Generation](/tools/image-generation) for shared tool parameters, provider selection, and failover behavior.
Video generation 
Registered video models:

- `vydra/veo3` for text-to-video (rejects image reference inputs)
- `vydra/kling` for image-to-video (requires exactly one remote image URL)

Set Vydra as the default video provider:

```json5
{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "vydra/veo3",
        },
      },
    },
  },
}
```

Notes:

- `vydra/kling` rejects local file uploads up front; only a remote image URL reference works.
- Vydra's `kling` HTTP route has been inconsistent about whether it requires `image_url` or `video_url`; the plugin sends the same remote image URL in both fields.
- The plugin stays conservative and does not forward undocumented style knobs such as aspect ratio, resolution, watermark, or generated audio.

See [Video Generation](/tools/video-generation) for shared tool parameters, provider selection, and failover behavior.
Video live tests 
Provider-specific live coverage:

```bash
APUS_LIVE_TEST=1 \
APUS_LIVE_VYDRA_VIDEO=1 \
pnpm test:live -- extensions/vydra/vydra.live.test.ts
```

The Vydra live file covers:

- `vydra/veo3` text-to-video
- `vydra/kling` image-to-video using a remote image URL

Override the remote image fixture when needed:

```bash
export APUS_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
```
Speech synthesis 
Set Vydra as the speech provider:

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

Defaults:

- Model: `elevenlabs/tts`
- Voice id: `21m00Tcm4TlvDq8ikWAM` ("Rachel")

The plugin exposes this one known-good default voice and returns MP3 audio files.

Related

Provider directory

Browse all available providers.

Image generation

Shared image tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

Configuration reference

Agent defaults and model configuration.