Agent 接入指南
将 Hermes 接入 WaveSpeed LLM API
本指南说明如何通过 ~/.hermes/config.yaml、OpenAI 兼容 Chat Completions、/v1/chat/completions、base URL https://llm.wavespeed.ai/v1 和默认模型 anthropic/claude-opus-4.8 将 Hermes 接入 WaveSpeed AI。复制上方配置,导出 API key,运行 agent,然后在 Logs 中验证请求。
创建 WaveSpeed Access Key
在本地导出所需密钥
将配置粘贴到
~/.hermes/config.yaml运行 hermes chat 并查看 Logs
这个 Hermes 配置会设置什么
协议
OpenAI 兼容 Chat Completions
Endpoint
/v1/chat/completions
模型
anthropic/claude-opus-4.8
上方可复制配置就是推荐方案下唯一需要编辑的 Hermes 文件:~/.hermes/config.yaml。API key 建议保留在 shell 环境变量中,避免提交到代码仓库。
常见问题排查
API key 没有生效
请在运行 Hermes 的同一个 shell 中导出 WAVESPEED_API_KEY。如果写入 shell profile,需要重新加载终端后再启动 agent。
请求出现协议或 endpoint 错误
确认 Hermes 使用的是 OpenAI 兼容 Chat Completions 和 endpoint /v1/chat/completions。协议不匹配是 404 或 payload 错误最常见的原因。
选择的模型不可用
先确认模型 ID 存在于 WaveSpeed Models,再将完整 ID 粘贴到 ~/.hermes/config.yaml。也可以先使用本页展示的默认模型。
Logs 中没有请求记录
确认 Hermes 使用的是 WaveSpeed base URL 和当前 API key。然后从本地 agent 发送一个新 prompt,并刷新 Logs。
这个 Hermes 指南可以被搜索到吗?
可以。这个页面被设计成可索引的接入指南,用来承接搜索 Hermes custom provider、OpenAI-compatible endpoint、base URL 和本地 agent 配置流程的用户。