Providers

Vydra

隨附的 Vydra 外掛新增:

  • 透過 vydra/grok-imagine 產生圖片
  • 透過 vydra/veo3(文字轉影片)和 vydra/kling(圖片轉影片)產生影片
  • 透過 Vydra 以 ElevenLabs 為後端的 TTS 路由進行語音合成

OpenClaw 對這三項功能使用相同的 VYDRA_API_KEY

屬性
提供者 ID vydra
外掛 隨附,enabledByDefault: true
驗證環境變數 VYDRA_API_KEY
初始設定旗標 --auth-choice vydra-api-key
直接命令列旗標 --vydra-api-key <key>
介面契約 imageGenerationProvidersvideoGenerationProvidersspeechProviders
基礎 URL https://www.vydra.ai/api/v1(使用 www 主機)

設定

  • 執行互動式初始設定

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

    或直接設定環境變數:

    bash
    export VYDRA_API_KEY="vydra_live_..."
  • 選擇預設功能

    從下列功能(圖片、影片或語音)中選擇一項或多項,並套用對應的設定。

  • 功能

    圖片產生

    預設且唯一隨附的圖片模型:

    • vydra/grok-imagine

    將其設為預設圖片提供者:

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

    隨附的支援僅限文字轉圖片,每次請求最多產生一張圖片。Vydra 託管的編輯路由需要遠端圖片 URL,而隨附的外掛不會新增 Vydra 專用的上傳橋接機制。

    影片產生

    已註冊的影片模型:

    • vydra/veo3 用於文字轉影片(拒絕圖片參照輸入)
    • vydra/kling 用於圖片轉影片(僅接受一個遠端圖片 URL)

    將 Vydra 設為預設影片提供者:

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

    注意事項:

    • vydra/kling 會直接拒絕本機檔案上傳;僅能使用遠端圖片 URL 參照。
    • Vydra 的 kling HTTP 路由對於要求使用 image_url 還是 video_url 並不一致;隨附的提供者會在兩個欄位中傳送相同的遠端圖片 URL。
    • 隨附的外掛採取保守做法,不會轉送未記載於文件中的樣式調整選項,例如長寬比、解析度、浮水印或產生的音訊。
    影片即時測試

    提供者專屬的即時測試範圍:

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

    隨附的 Vydra 即時測試檔案涵蓋:

    • vydra/veo3 文字轉影片
    • vydra/kling 使用遠端圖片 URL 進行圖片轉影片

    需要時可覆寫遠端圖片測試資料:

    bash
    export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
    語音合成

    將 Vydra 設為語音提供者:

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

    預設值:

    • 模型:elevenlabs/tts
    • 語音 ID:21m00Tcm4TlvDq8ikWAM(「Rachel」)

    隨附的外掛提供這個已知運作良好的預設語音,並傳回 MP3 音訊檔案。

    相關資源

    Was this useful?
    On this page

    On this page