openrouter免费额度需创建free tier密钥并请求中指定"provider": "free"；hermes agent需在workspace绑定额度并启用sandbox mode；二者额度独立不可混用，异常消耗须立即终止活跃会话与未授权webhook。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenRouter 或 Hermes Agent 时看到“免费额度”提示，但不清楚如何有效调用或避免意外扣费，则可能是由于未明确区分平台计费规则与额度归属机制。以下是针对这两个平台免费额度的具体使用方式：
一、OpenRouter 免费额度的激活与消耗路径
OpenRouter 的免费额度为新注册用户一次性发放，用于抵扣 API 调用产生的 token 费用，额度不按月重置，仅限个人账户使用，且不可转让或叠加。该额度在每次请求成功响应后实时扣除，优先于任何付费计划生效。
1、访问 https://openrouter.ai/keys 并登录您的账户。
2、在 API Keys 页面点击【Create new key】，选择【Free tier only】选项并确认生成。
3、将生成的 key 复制到您使用的客户端（如 curl 命令、Python requests 或 VS Code 插件）的 Authorization 请求头中。
4、发起请求时确保请求体中包含 "provider": "free" 字段，否则系统默认走付费通道。
5、调用完成后，返回响应头中的 X-RateLimit-Remaining 值即为当前剩余免费额度单位（以千 token 计）。
二、Hermes Agent 免费额度的绑定与触发条件
Hermes Agent 的免费额度需手动绑定至具体工作区（Workspace），且仅对启用“Sandbox Mode”的会话生效。该额度不自动继承至子账户或团队空间，也不同步至历史会话记录，必须在新建会话前完成配置。
1、登录 Hermes Agent 控制台，进入目标 Workspace 的 Settings → Billing → Free Quota 页面。
2、点击【Enable for this workspace】按钮，并从下拉菜单中选择已验证的邮箱账户作为额度归属主体。
3、返回会话创建界面，在高级选项中勾选 "Use sandbox mode with free quota"。
4、启动会话后，界面右上角将显示 "Free: Active" 标识，此时所有推理、检索、执行操作均计入免费额度消耗。
5、若界面出现 "Quota exhausted" 提示，需等待系统每日 UTC 00:00 自动重置，或切换至其他已绑定额度的工作区。
三、跨平台额度混用风险规避方法
OpenRouter 与 Hermes Agent 的免费额度完全独立，不存在互通、共享或转换机制。若在 Hermes Agent 中配置 OpenRouter 模型作为后端，其调用费用仍由 OpenRouter 侧结算，Hermes Agent 不代为承担或抵扣，此时两个平台的额度将分别消耗。
1、在 Hermes Agent 的模型配置页中，禁用所有标有 "External Provider" 的选项，仅保留内置模型列表中的条目。
2、检查 OpenRouter 的请求日志，确认每条记录的 "model" 字段值是否属于 free-tier-only 白名单（如 `google/gemma-2-9b-it`, `microsoft/phi-3-mini-4k-instruct`）。
3、在 Hermes Agent 的 CLI 工具中运行 hermes config show --quota，验证输出中 "bound_to_openrouter" 字段为 false。
4、若需组合使用，应在 OpenRouter 侧单独申请测试密钥，并通过环境变量 OPENROUTER_API_KEY 显式传入，不得复用 Hermes Agent 的主密钥。
四、额度异常消耗的即时拦截操作
当发现免费额度在无主动调用情况下快速减少，大概率是后台服务、Webhook 或第三方集成持续轮询导致。此时应立即冻结非必要连接，而非等待额度归零后再处理。
1、登录 OpenRouter 控制台，进入 Usage → Active Sessions，筛选状态为 "Streaming" 的长期连接并点击【Terminate】。
2、在 Hermes Agent 的 Integrations → Webhooks 页面中，关闭所有未标注用途的 endpoint，尤其是含 /callback 或 /notify 路径的条目。
3、打开浏览器开发者工具，切换至 Network 标签页，刷新 Hermes Agent 界面，筛选出所有包含 openrouter 或 hermes 的请求，右键复制为 cURL，核查是否存在重复 headers 或未授权 referrer。
4、在终端执行 lsof -i :3000 | grep LISTEN（假设本地服务运行在 3000 端口），终止所有非预期的监听进程。
