Providers 导读

一个 API Key 管三种生成,但 base URL 写错会静默失败

Vydra 插件同时支持图片(grok-imagine)、视频(veo3/kling)和语音合成(ElevenLabs 路由),三个能力共用同一个 VYDRA_API_KEY。最坑的是 base URL 必须写成 https://www.vydra.ai/api/v1,如果漏了 www,跨域重定向会吞掉 Authorization 头,导致 Key 明明有效却报错。配置时先跑 openclaw onboard --auth-choice vydra-api-key 或直接 export 环境变量,然后到 agent defaults 里把 imageGenerationModel 设成 vydra/grok-imagine 就能用。

先讲这一页到底在解决什么

一个 API Key 管三种生成,但 base URL 写错会静默失败

Vydra 插件同时支持图片(grok-imagine)、视频(veo3/kling)和语音合成(ElevenLabs 路由),三个能力共用同一个 VYDRA_API_KEY。最坑的是 base URL 必须写成 https://www.vydra.ai/api/v1,如果漏了 www,跨域重定向会吞掉 Authorization 头,导致 Key 明明有效却报错。配置时先跑 openclaw onboard --auth-choice vydra-api-key 或直接 export 环境变量,然后到 agent defaults 里把 imageGenerationModel 设成 vydra/grok-imagine 就能用。

原文共 4 节,先看 Start Here 路径:/providers/vydra 查看官方原文

第一步

🌐 先记住门牌号:必须走 `www`

这页最像排错提醒:门牌不对,授权可能会被跨域重定向弄丢。

https://www.vydra.ai/api/v1

正确门牌。

https://vydra.ai/api/v1

看起来像,但官方不推荐拿它直接做入口。

为什么这么较真

因为有些客户端会在跨域重定向时丢授权头。

第二步

🎨 图、视频、声音都共用同一把工牌

Vydra 的卖点就是多功能,不是只会做某一类媒体。

🖼

Image

vydra/grok-imagine

🎥

Video

vydra/veo3 / vydra/kling

🔊

TTS

ElevenLabs-backed 语音路线。

🪪

VYDRA_API_KEY

三条线共用一把钥匙。

第三步

📦 它的限制也很清楚:有些活只给远程图,不给本地文件

尤其是 Kling 这条视频线,官方把边界说得很明确。

Image edit

当前还偏向文本到图,编辑能力有边界。

Video

会带着不同模型各走各的路。

Local file

某些视频路由只认远程图片 URL,不吃本地文件。

最后总结

🎈 把 Vydra 这页压成一句最好记的话

Vydra 是一条多功能生产线:图、视频、声音都能做,但门牌要写对,尤其要走 `www` 那个入口。