龙虾（Hermes）接入

如果你使用龙虾（Hermes），先 创建 API 密钥，选择支持目标 GPT 模型的分组。文本订阅或分组不能直接当作生图分组使用。

1. 准备接入信息

在控制台确认密钥所属分组、可用模型名称和请求地址。Hermes 中不同 Provider 对地址格式的要求可能不同：配置助手需要站点地址时，使用根地址；填写 OpenAI 兼容 Base URL 时，使用 /v1。

配置项	内容
站点根地址	https://api.259aitoken.com
OpenAI 兼容 Base URL	https://api.259aitoken.com/v1
API Key	你在 259AI 创建的完整密钥
模型名	当前密钥分组支持的完整 GPT 模型名

2. 通过 Hermes 配置入口接入

先确认已经安装 Hermes。在终端运行：

hermes model

选择 Custom endpoint（自定义端点），依次填写：

1. API Base URL：https://api.259aitoken.com/v1。
2. API Key：从 259AI 复制的完整密钥。
3. Model：当前分组支持的完整 GPT 模型名。

保存后退出原会话，重新启动 Hermes。会话内的 /model 用于切换已配置的 Provider；首次添加自定义端点，请使用终端里的 hermes model。

配置入口说明见 Hermes 官方文档。

让 Agent 协助配置

如果你的 Hermes Agent 支持配置自定义 API，可以将下面提示词交给它。替换模型名称；真实密钥通过自己的本机配置入口提供，不要求 Agent 在回复中复述密钥。

帮我为 Hermes 配置 259AI 的 OpenAI 兼容 GPT 接入。
站点根地址：https://api.259aitoken.com
OpenAI 兼容 Base URL：https://api.259aitoken.com/v1
模型名称：替换为我的密钥分组支持的完整模型名
API Key：由我通过本机配置提供，请不要在回复或日志中输出密钥。
请保留其他 Provider，说明保存到了哪个配置入口，以及如何启用。
配置完成后，先发一条只需简短回复的测试请求。

如果 Agent 不能修改配置，请回到上面的 hermes model 交互式入口，手动填写同一组信息。

3. 确认接入结果

1. 确认 Hermes 当前启用了刚配置的 Provider 和模型。
2. 新建会话发送“请只回复：连接成功。不要读取文件或执行命令。”，等待完整回复。
3. 回到 259AI 使用记录，按密钥和测试时间核对模型与消耗。

测试按正常规则计费。Agent 说“配置完成”，不能代替实际请求和使用记录核对。

失败时先查什么？

认证失败先检查完整密钥和启用状态；404 先检查模型、分组，以及是否出现重复 /v1/v1 或完整接口路径；429 要分清额度与繁忙，详见 接入报错与排查。

需要帮助可加入 QQ 群 1103052862，提供客户端版本、北京时间、模型和已脱敏错误信息。