前置准备
开始前，请准备以下信息：- API Key：前往 API 密钥管理 创建或复制 API Key。
- Base URL：
https://api.ppio.com/openai/v1 - Model ID：前往模型广场或模型详情页，复制需要使用的模型 ID，例如
deepseek/deepseek-v4.1-flash。
安装 Hermes
Hermes 提供终端版与桌面版，按需选择一种方式安装。Linux / macOS / WSL2
Windows PowerShell
Desktop
也可以访问 Hermes Desktop 页面下载安装：配置 PPIO endpoint
安装完成后，运行 Hermes 配置向导。不同版本的命令入口可能略有差异，以 Hermes 终端提示为准。 配置过程中，按以下方式选择和填写：1
选择自定义提供商
选择 Custom endpoint 或手动输入 URL 的自定义提供商。
2
填写 Base URL
在 Base URL 中填写：
https://api.ppio.com/openai/v13
填写 API Key
在 API Key 中填写您的 PPIO API Key。
4
选择 API 类型
在 API 类型中选择默认自动检测。如需手动指定，请选择 OpenAI-compatible / Chat Completions 相关模式。
5
选择模型
在模型列表中选择目标模型，或手动输入 PPIO 模型 ID，例如
deepseek/deepseek-v4.1-flash。6
设置 max tokens
根据模型上下文长度设置 max tokens；不确定时可保留默认或自动检测。
7
为配置命名
为该模型配置设置一个便于识别的名称，例如
ppio-deepseek-v4.1-flash。8
选择运行环境
如果仅在本地使用，运行环境选择默认的 Local。
9
跳过渠道集成
如果不需要连接 Telegram、Slack、Matrix 等渠道，集成渠道保持跳过即可。
刷新终端配置
如果 Hermes 安装完成后提示需要刷新 shell，请执行：启动 Hermes
在终端中启动 Hermes：- API Key 是否填写正确。
- Base URL 是否为
https://api.ppio.com/openai/v1。 - 模型 ID 是否与 PPIO 模型详情页保持一致。
- 当前选择的 API 类型是否兼容 OpenAI-compatible endpoint。