Vydra

번들 Vydra Plugin은 다음 기능을 추가합니다.

vydra/grok-imagine을 통한 이미지 생성
vydra/veo3(텍스트-비디오) 및 vydra/kling(이미지-비디오)을 통한 비디오 생성
Vydra의 ElevenLabs 기반 TTS 경로를 통한 음성 합성

OpenClaw는 세 기능 모두에 동일한 VYDRA_API_KEY를 사용합니다.

속성	값
제공자 ID	`vydra`
Plugin	번들됨, `enabledByDefault: true`
인증 환경 변수	`VYDRA_API_KEY`
온보딩 플래그	`--auth-choice vydra-api-key`
직접 CLI 플래그	`--vydra-api-key <key>`
계약	`imageGenerationProviders`, `videoGenerationProviders`, `speechProviders`
기본 URL	`https://www.vydra.ai/api/v1` (`www` 호스트 사용)

기본 URL로 https://www.vydra.ai/api/v1을 사용하세요. 현재 Vydra의 최상위 호스트(https://vydra.ai/api/v1)는 www로 리디렉션됩니다. 일부 HTTP 클라이언트는 이 교차 호스트 리디렉션에서 Authorization을 제거하므로, 유효한 API 키가 오해를 유발하는 인증 실패로 처리될 수 있습니다. 이를 방지하기 위해 번들 Plugin은 구성된 모든 vydra.ai 기본 URL을 www.vydra.ai로 정규화합니다.

설정

대화형 온보딩 실행

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

또는 환경 변수를 직접 설정합니다.

export VYDRA_API_KEY="vydra_live_..."

기본 기능 선택

아래 기능(이미지, 비디오 또는 음성) 중 하나 이상을 선택하고 해당 구성을 적용합니다.

기능

이미지 생성

기본이자 유일한 번들 이미지 모델:

vydra/grok-imagine

기본 이미지 제공자로 설정합니다.

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

번들 지원은 텍스트-이미지 전용이며 요청당 최대 하나의 이미지만 생성합니다. Vydra의 호스팅 편집 경로에는 원격 이미지 URL이 필요하며, 번들 Plugin은 Vydra 전용 업로드 브리지를 추가하지 않습니다.

공통 도구 매개변수, 제공자 선택 및 장애 조치 동작은 이미지 생성을 참조하세요.

비디오 생성

등록된 비디오 모델:

텍스트-비디오용 vydra/veo3(이미지 참조 입력 거부)
이미지-비디오용 vydra/kling(원격 이미지 URL 정확히 하나 필요)

Vydra를 기본 비디오 제공자로 설정합니다.

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

참고:

vydra/kling은 로컬 파일 업로드를 사전에 거부하며, 원격 이미지 URL 참조만 사용할 수 있습니다.
Vydra의 kling HTTP 경로는 image_url과 video_url 중 어느 필드를 요구하는지가 일관되지 않았습니다. 번들 제공자는 두 필드 모두에 동일한 원격 이미지 URL을 전송합니다.
번들 Plugin은 보수적으로 동작하며 가로세로비, 해상도, 워터마크 또는 생성 오디오와 같이 문서화되지 않은 스타일 설정을 전달하지 않습니다.

공통 도구 매개변수, 제공자 선택 및 장애 조치 동작은 비디오 생성을 참조하세요.

비디오 라이브 테스트

제공자별 라이브 검증 범위:

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

번들 Vydra 라이브 파일은 다음을 검증합니다.

vydra/veo3 텍스트-비디오
원격 이미지 URL을 사용하는 vydra/kling 이미지-비디오

필요한 경우 원격 이미지 픽스처를 재정의합니다.

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

음성 합성

Vydra를 음성 제공자로 설정합니다.

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

기본값:

모델: elevenlabs/tts
음성 ID: 21m00Tcm4TlvDq8ikWAM(“Rachel”)

번들 Plugin은 정상 작동이 확인된 이 기본 음성 하나를 제공하며 MP3 오디오 파일을 반환합니다.

제공자 디렉터리

사용 가능한 모든 제공자를 살펴봅니다.

이미지 생성

공통 이미지 도구 매개변수와 제공자 선택입니다.

비디오 생성

공통 비디오 도구 매개변수와 제공자 선택입니다.

구성 참조

에이전트 기본값과 모델 구성입니다.

Overview

Concepts and configuration

Providers

설정

기능

관련 항목

제공자 디렉터리

이미지 생성

비디오 생성

구성 참조

​설정

​기능

​관련 항목

제공자 디렉터리

이미지 생성

비디오 생성

구성 참조

설정

기능

관련 항목