🌋火山 Agent Hub
近 7 天用量
输入 Tokens
输出 Tokens
Key 今日用量
访问令牌用量 近24小时 · RPM/TPM 为近1分钟实时速率
今日模型用量
上游 Key 列表
平台访问令牌
客户端调用本网关时使用的令牌（Authorization: Bearer 或 x-api-key 携带），可按令牌配置模型白名单、分组路由限制（仅路由指定分组的 Key）、使用量限额（每日 / 累计：请求数 / Tokens / AFP）与速率限制（RPM / TPM，近1分钟滑动窗口）。所有接口默认强制鉴权：未创建任何令牌时网关拒绝一切调用，创建令牌后客户端必须携带。
模型目录
依据官方《Agent Plan 企业版》支持模型及 Harness 列表维护；“对外暴露”的模型将通过 /v1/models 与 /anthropic/v1/models 提供，供 CC Switch「获取模型」、Claude Code 等工具自动拉取；AFP 系数修改后实时生效（优先级：系统设置自定义系数 > 本目录系数 > 内置系数表）。
模型列表获取接口
CC Switch 添加/编辑供应商时填入网关地址与平台访问令牌，点击模型输入框旁的「获取模型」即可拉取；Claude Code 等原生 Anthropic 客户端使用 /anthropic/v1/models
接口说明
| 接口 | 格式 | 适用工具 |
|---|---|---|
| GET /v1/models | OpenAI 兼容 | CC Switch、Cursor、Cline 等 |
| GET /models | OpenAI 兼容 | CC Switch 剥离 /anthropic 子路径后的兑底候选 |
| GET /anthropic/v1/models | Anthropic | Claude Code（/model 列表） |
| GET /anthropic/models | Anthropic | 兼容 cc-switch 的 baseURL+/models 候选 |
鉴权与代理接口一致：必须携带有效令牌（未创建任何令牌时接口一律拒绝），且按令牌模型白名单过滤返回结果。
请求日志
客户端接入指南
将工具的 API 地址指向本网关，使用「平台访问令牌」作为 API Key（在「访问令牌」页创建；接口强制鉴权，必须携带令牌调用）。网关会自动选择可用 Key 并在限流时无感切换。
Claude Code（Anthropic 协议）
写入 ~/.zshrc 或 ~/.bashrc 后执行 source 生效；支持 /anthropic/* 路径前缀
Cursor / OpenAI 协议工具
适用于 Cursor、Cline 等 OpenAI 兼容客户端，在工具的自定义 OpenAI 服务商设置中填入上方地址；支持 /v1/* 路径前缀
CC Switch / 模型列表获取
在 CC Switch（Claude Code / Codex 供应商切换工具）中新增供应商：端点地址填下方网关地址，API Key 填平台访问令牌，点击模型输入框旁的「获取模型」按钮即可自动拉取「模型列表」页对外暴露的模型（OpenAI 兼容 /v1/models）。
· 模型目录在「模型列表」页维护，可新增/编辑/隐藏
· 配置了访问令牌时需携带令牌获取，且按令牌白名单过滤
· Claude Code 原生使用 /anthropic/v1/models
· 配置了访问令牌时需携带令牌获取，且按令牌白名单过滤
· Claude Code 原生使用 /anthropic/v1/models
请求头说明
| Header | 说明 |
|---|---|
| Authorization: Bearer <令牌> | 平台访问令牌，与 x-api-key 任选其一（OpenAI 协议常用 Bearer） |
| x-api-key: <令牌> | 平台访问令牌（Anthropic 协议常用）；可按令牌配置模型白名单与使用量限额 |
| X-Key-Hint: <Key名称或ID> | 指定使用某个上游 Key（调试用，Key 不可用时自动回退正常调度） |
| X-Key-Used | 响应头：本次请求实际使用的 Key |
| X-Request-ID | 响应头：调用链 ID，排查问题时提供给管理员检索服务端日志 |
使用提示
· 上游限流（429）时网关自动冷却该 Key 并切换到其它 Key 重试，客户端无感
· 可用模型见「模型列表」页（依据官方 Agent Plan 企业版文档维护，可自行增删改）
· Key 支持模型白名单（如某 Key 只允许 kimi-k2.7-code）
· Key 支持分组（可属多个组），访问令牌可限定仅路由指定分组的 Key，实现多团队 Key 隔离
· 访问令牌支持模型白名单、分组路由限制、使用量限额（每日/累计：请求数 / Tokens / AFP）与速率限制（RPM/TPM，近1分钟滑动窗口）
· 单 Key 每日/累计用量见「概览」与「Key 管理」页
· 可用模型见「模型列表」页（依据官方 Agent Plan 企业版文档维护，可自行增删改）
· Key 支持模型白名单（如某 Key 只允许 kimi-k2.7-code）
· Key 支持分组（可属多个组），访问令牌可限定仅路由指定分组的 Key，实现多团队 Key 隔离
· 访问令牌支持模型白名单、分组路由限制、使用量限额（每日/累计：请求数 / Tokens / AFP）与速率限制（RPM/TPM，近1分钟滑动窗口）
· 单 Key 每日/累计用量见「概览」与「Key 管理」页
网关设置
触发限流后该 Key 暂时下线的时间（默认 600 = 10 分钟），连续限流会指数递增
连续限流冷却时长的上限（默认 86400 = 24 小时）
自动添加 stream_options 以获取流式请求的精确 tokens 用量
AFP 抵扣系数
不在内置系数表中的模型按此系数计算 AFP
Anthropic 协议的 cache 读/写 tokens 是否计入 AFP 输入
内置系数（文本/向量化）：mini 0.25 · lite / deepseek-v4-flash / embedding-vision 0.5 · seed-2.1-turbo / seed-evolving / minimax-m3 2.5 · kimi-k2.7-code / glm-5.2 / glm-5.3 / glm-latest 4.5 · deepseek-v4-pro 5.5；输入分段系数：≤32k ×0.67，32k~128k ×1，>128k ×2
AFP = (输入token × 模型系数 × 输入分段系数 + 输出token × 模型系数) / 10000
AFP = (输入token × 模型系数 × 输入分段系数 + 输出token × 模型系数) / 10000
配置备份与迁移 Key / 访问令牌配置
导出全部上游 Key（可选包含访问令牌）配置为 JSON 文件，用于备份恢复或多实例迁移；导入时按席位 ID / API Key 匹配去重，支持合并 / 仅新增 / 覆盖三种模式。配置文件包含明文密钥，请在可信环境传输与保存。
账户信息
管理员账户，用于登录本管理后台
修改密码
安全建议
· 密码长度至少 6 位，建议包含字母、数字与符号
· 定期更换密码，避免与其他平台共用
· 管理端登录会话有效期 7 天，到期后需重新登录
· 忘记密码：在服务器上执行 ./volc-agent-hub reset-admin 重置（建议先停止服务）
· 定期更换密码，避免与其他平台共用
· 管理端登录会话有效期 7 天，到期后需重新登录
· 忘记密码：在服务器上执行 ./volc-agent-hub reset-admin 重置（建议先停止服务）