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> |
| 介面契約 | imageGenerationProviders、videoGenerationProviders、speechProviders |
| 基礎 URL | https://www.vydra.ai/api/v1(使用 www 主機) |
設定
執行互動式初始設定
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,而隨附的外掛不會新增 Vydra 專用的上傳橋接機制。
影片產生
已註冊的影片模型:
vydra/veo3用於文字轉影片(拒絕圖片參照輸入)vydra/kling用於圖片轉影片(僅接受一個遠端圖片 URL)
將 Vydra 設為預設影片提供者:
{ agents: { defaults: { videoGenerationModel: { primary: "vydra/veo3", }, }, },}注意事項:
vydra/kling會直接拒絕本機檔案上傳;僅能使用遠端圖片 URL 參照。- Vydra 的
klingHTTP 路由對於要求使用image_url還是video_url並不一致;隨附的提供者會在兩個欄位中傳送相同的遠端圖片 URL。 - 隨附的外掛採取保守做法,不會轉送未記載於文件中的樣式調整選項,例如長寬比、解析度、浮水印或產生的音訊。
影片即時測試
提供者專屬的即時測試範圍:
OPENCLAW_LIVE_TEST=1 \OPENCLAW_LIVE_VYDRA_VIDEO=1 \pnpm test:live -- extensions/vydra/vydra.live.test.ts隨附的 Vydra 即時測試檔案涵蓋:
vydra/veo3文字轉影片vydra/kling使用遠端圖片 URL 進行圖片轉影片
需要時可覆寫遠端圖片測試資料:
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」)
隨附的外掛提供這個已知運作良好的預設語音,並傳回 MP3 音訊檔案。
相關資源
Was this useful?