Providers

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)

Configuração

  • Execute a integração inicial interativa

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

    Ou defina diretamente a variável de ambiente:

    bash
    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:

    json5
    {  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.

    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:

    json5
    {  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.
    Testes ao vivo de vídeo

    Cobertura de testes ao vivo específica do provedor:

    bash
    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:

    bash
    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    Síntese de fala

    Defina a Vydra como o provedor de fala:

    json5
    {  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

    Was this useful?
    On this page

    On this page