Vydra Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Vydra

개요

이 페이지는 OpenClaw Vydra provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Vydra image, video, and speech in OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Property	Value
Provider id	vydra
Plugin	bundled, enabledByDefault: true
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)

공식 문서 기반 상세

아래는 공식 providers/vydra 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

The bundled Vydra plugin adds:

• Image generation via vydra/grok-imagine
• Video generation via vydra/veo3 (text-to-video) and vydra/kling (image-to-video)
• Speech synthesis via Vydra's ElevenLabs-backed TTS route

OpenClaw uses the same VYDRA_API_KEY for all three capabilities.

Property	Value
Provider id	vydra
Plugin	bundled, enabledByDefault: true
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.

설정

Run interactive onboarding

```bash
openclaw 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.

기능

이미지 생성

Default and only bundled image model:

- `vydra/grok-imagine`

Set it as the default image provider:

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

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

See Image Generation for shared tool parameters, provider selection, and failover behavior.

비디오 생성

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: {
      videoGenerationModel: {
        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 bundled provider sends the same remote image URL in both fields.
- The bundled plugin stays conservative and does not forward undocumented style knobs such as aspect ratio, resolution, watermark, or generated audio.

See Video Generation for shared tool parameters, provider selection, and failover behavior.

Video live tests

Provider-specific live coverage:

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

The bundled 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 OPENCLAW_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 bundled plugin exposes this one known-good default voice and returns MP3 audio files.

관련 문서

Browse all available providers.


Shared image tool parameters and provider selection.


Shared video tool parameters and provider selection.


Agent defaults and model configuration.

검증 체크리스트

• openclaw models list --provider vydra 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers