Vydra

Il Plugin Vydra incluso aggiunge:

Generazione di immagini tramite vydra/grok-imagine
Generazione di video tramite vydra/veo3 (da testo a video) e vydra/kling (da immagine a video)
Sintesi vocale tramite il percorso TTS di Vydra basato su ElevenLabs

OpenClaw utilizza la stessa VYDRA_API_KEY per tutte e tre le funzionalità.

Proprietà	Valore
ID del provider	`vydra`
Plugin	incluso, `enabledByDefault: true`
Variabile d’ambiente per l’autenticazione	`VYDRA_API_KEY`
Flag di configurazione iniziale	`--auth-choice vydra-api-key`
Flag CLI diretto	`--vydra-api-key <key>`
Contratti	`imageGenerationProviders`, `videoGenerationProviders`, `speechProviders`
URL di base	`https://www.vydra.ai/api/v1` (utilizzare l’host `www`)

Utilizzare https://www.vydra.ai/api/v1 come URL di base. L’host radice di Vydra (https://vydra.ai/api/v1) attualmente reindirizza a www. Alcuni client HTTP omettono Authorization durante questo reindirizzamento tra host, trasformando una chiave API valida in un fuorviante errore di autenticazione. Per evitarlo, il Plugin incluso normalizza qualsiasi URL di base vydra.ai configurato in www.vydra.ai.

Configurazione

Eseguire la configurazione iniziale interattiva

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

In alternativa, impostare direttamente la variabile d’ambiente:

export VYDRA_API_KEY="vydra_live_..."

Scegliere una funzionalità predefinita

Scegliere una o più delle funzionalità seguenti (immagine, video o voce) e applicare la configurazione corrispondente.

Funzionalità

Generazione di immagini

Modello di immagini predefinito e unico incluso:

vydra/grok-imagine

Impostarlo come provider di immagini predefinito:

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

Il supporto incluso consente esclusivamente la generazione da testo a immagine, con al massimo un’immagine per richiesta. I percorsi di modifica ospitati da Vydra richiedono URL di immagini remote e il Plugin incluso non aggiunge un bridge di caricamento specifico per Vydra.

Consultare Generazione di immagini per i parametri condivisi dello strumento, la selezione del provider e il comportamento di failover.

Generazione di video

Modelli video registrati:

vydra/veo3 per la generazione da testo a video (rifiuta gli input con immagini di riferimento)
vydra/kling per la generazione da immagine a video (richiede esattamente un URL di immagine remota)

Impostare Vydra come provider video predefinito:

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

Note:

vydra/kling rifiuta immediatamente il caricamento di file locali; funziona solo un riferimento a un URL di immagine remota.
Il percorso HTTP kling di Vydra ha mostrato incoerenze riguardo alla necessità di image_url o video_url; il provider incluso invia lo stesso URL dell’immagine remota in entrambi i campi.
Il Plugin incluso adotta un approccio prudente e non inoltra opzioni di stile non documentate, come proporzioni, risoluzione, filigrana o audio generato.

Consultare Generazione di video per i parametri condivisi dello strumento, la selezione del provider e il comportamento di failover.

Test live dei video

Copertura live specifica del provider:

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

Il file live di Vydra incluso copre:

Generazione da testo a video con vydra/veo3
Generazione da immagine a video con vydra/kling utilizzando un URL di immagine remota

Sovrascrivere il fixture dell’immagine remota quando necessario:

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

Sintesi vocale

Impostare Vydra come provider vocale:

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

Valori predefiniti:

Modello: elevenlabs/tts
ID voce: 21m00Tcm4TlvDq8ikWAM (“Rachel”)

Il Plugin incluso espone questa singola voce predefinita di comprovata affidabilità e restituisce file audio MP3.

Risorse correlate

Directory dei provider

Esplorare tutti i provider disponibili.

Generazione di immagini

Parametri condivisi dello strumento per immagini e selezione del provider.

Generazione di video

Parametri condivisi dello strumento per video e selezione del provider.

Riferimento della configurazione

Valori predefiniti degli agenti e configurazione dei modelli.

Overview

Concepts and configuration

Providers

Configurazione

Funzionalità

Risorse correlate

Directory dei provider

Generazione di immagini

Generazione di video

Riferimento della configurazione

​Configurazione

​Funzionalità

​Risorse correlate

Directory dei provider

Generazione di immagini

Generazione di video

Riferimento della configurazione

Configurazione

Funzionalità

Risorse correlate