Vydra

O Plugin Vydra incluído adiciona:

Geração de imagens via vydra/grok-imagine
Geração de vídeos via vydra/veo3 (texto para vídeo) e vydra/kling (imagem para vídeo)
Síntese de fala por meio da rota TTS da Vydra, baseada no ElevenLabs

O OpenClaw usa a mesma VYDRA_API_KEY para as três funcionalidades.

Propriedade	Valor
ID do provedor	`vydra`
Plugin	incluído, `enabledByDefault: true`
Variável de ambiente de autenticação	`VYDRA_API_KEY`
Opção de integração inicial	`--auth-choice vydra-api-key`
Opção direta da CLI	`--vydra-api-key <key>`
Contratos	`imageGenerationProviders`, `videoGenerationProviders`, `speechProviders`
URL base	`https://www.vydra.ai/api/v1` (use o host `www`)

Use https://www.vydra.ai/api/v1 como URL base. Atualmente, o host raiz da Vydra (https://vydra.ai/api/v1) redireciona para www. Alguns clientes HTTP removem o cabeçalho Authorization nesse redirecionamento entre hosts, fazendo com que uma chave de API válida resulte em uma falha de autenticação enganosa. Para evitar isso, o Plugin incluído normaliza qualquer URL base vydra.ai configurada para www.vydra.ai.

Configuração

Execute a integração inicial interativa

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

Ou defina diretamente a variável de ambiente:

export VYDRA_API_KEY="vydra_live_..."

Escolha uma funcionalidade padrão

Escolha uma ou mais das funcionalidades abaixo (imagem, vídeo ou fala) e aplique a configuração correspondente.

Funcionalidades

Geração de imagens

Modelo de imagem padrão e único incluído:

vydra/grok-imagine

Defina-o como o provedor de imagens padrão:

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

O suporte incluído abrange apenas texto para imagem, com no máximo uma imagem por solicitação. As rotas de edição hospedadas da Vydra esperam URLs de imagens remotas, e o Plugin incluído não adiciona uma ponte de upload específica para a Vydra.

Consulte Geração de imagens para ver os parâmetros compartilhados da ferramenta, a seleção de provedor e o comportamento de failover.

Geração de vídeos

Modelos de vídeo registrados:

vydra/veo3 para texto para vídeo (rejeita entradas de referência de imagem)
vydra/kling para imagem para vídeo (requer exatamente uma URL de imagem remota)

Defina a Vydra como o provedor de vídeos padrão:

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

Observações:

vydra/kling rejeita antecipadamente uploads de arquivos locais; apenas uma referência por URL de imagem remota funciona.
A rota HTTP kling da Vydra tem apresentado inconsistência quanto à exigência de image_url ou video_url; o provedor incluído envia a mesma URL de imagem remota nos dois campos.
O Plugin incluído mantém uma abordagem conservadora e não encaminha opções de estilo não documentadas, como proporção da imagem, resolução, marca-d’água ou áudio gerado.

Consulte Geração de vídeos para ver os parâmetros compartilhados da ferramenta, a seleção de provedor e o comportamento de failover.

Testes ao vivo de vídeo

Cobertura de testes ao vivo específica do provedor:

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

O arquivo de testes ao vivo da Vydra incluído abrange:

Texto para vídeo com vydra/veo3
Imagem para vídeo com vydra/kling, usando uma URL de imagem remota

Substitua o recurso de teste de imagem remota quando necessário:

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

Síntese de fala

Defina a Vydra como o provedor de fala:

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

Padrões:

Modelo: elevenlabs/tts
ID da voz: 21m00Tcm4TlvDq8ikWAM (“Rachel”)

O Plugin incluído disponibiliza essa única voz padrão comprovadamente funcional e retorna arquivos de áudio MP3.

Relacionados

Diretório de provedores

Explore todos os provedores disponíveis.

Geração de imagens

Parâmetros compartilhados da ferramenta de imagens e seleção de provedor.

Geração de vídeos

Parâmetros compartilhados da ferramenta de vídeos e seleção de provedor.

Referência de configuração

Padrões dos agentes e configuração de modelos.

Overview

Concepts and configuration

Providers

Configuração

Funcionalidades

Relacionados

Diretório de provedores

Geração de imagens

Geração de vídeos

Referência de configuração

​Configuração

​Funcionalidades

​Relacionados

Diretório de provedores

Geração de imagens

Geração de vídeos

Referência de configuração

Configuração

Funcionalidades

Relacionados