🌋火山 Agent Hub
近 7 天用量
输入 Tokens
输出 Tokens
关键性能指标
TTFT（首字耗时）：流式请求=首个生成事件到达，非流式=整包响应耗时；TPOT（每输出 token 耗时）：(总耗时−TTFT)/(输出 tokens−1)，仅统计流式请求；p90 为成功请求采样的 90 分位。RPM/TPM 按 1 分钟粒度聚合，最大 RPM/TPM 为窗口内单分钟峰值。基于请求日志聚合，受日志保留条数限制，覆盖时段可能短于所选窗口。
TTFT p90 首字耗时 · ms
TPOT p90 每输出 token 耗时 · ms
RPM 趋势 每分钟请求数
TPM 趋势 每分钟 Tokens
Key 今日用量
访问令牌用量 近24小时 · RPM/TPM 为近1分钟实时速率
今日模型用量
上游 Key 列表
官方席位列表
火山引擎 ListSeatInfos 最近一次同步的全部席位（含未导入本网关的席位）：套餐档位、计费/绑定状态、到期时间、自动续费、限流配置、绑定用户等官方基础信息；未导入席位可一键「导入为 Key」（实时拉取最新 APIKey 与到期时间，按席位去重）。
平台访问令牌
客户端调用本网关时使用的令牌（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（在「访问令牌」页创建；接口强制鉴权，必须携带令牌调用）。点击「复制完整文档（Markdown）」可获得一份自包含的接入文档--含网关地址、认证方式、各客户端配置、curl 快速验证与当前可用模型列表，可直接发送给使用者，或原样粘贴给 AI 助手由其代为完成配置与连通性测试。
默认自动填充当前访问地址（正式域名访问即为正式地址）；若你经 localhost / SSH 隧道等地址访问后台，请改为使用者可访问的正式地址
默认使用占位符；选择某个令牌后，文档中将携带真实令牌，可直接发给使用者
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 输入
内置系数（文本/向量化，Agent Plan 企业版：输入/输出系数相同）：mini 0.25 · lite / deepseek-v4-flash / glm-5.3-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
AFP = (输入token + 输出token) × 模型系数 / 10000（企业版系数不随输入长度变化；缓存命中默认计入输入）
AFP = (输入token + 输出token) × 模型系数 / 10000（企业版系数不随输入长度变化；缓存命中默认计入输入）
官方席位同步 火山引擎 GetSeatAFPUsage / ListSeatInfos
配置火山引擎 Access Key（需 ark 只读权限，如 ArkReadOnlyAccess）后开启两类官方同步：
① 用量同步（GetSeatAFPUsage，默认 5 分钟）：拉取席位的官方真实 AFP 用量（近5小时 / 近1天 / 近1周 / 近1月四窗口，含席位在其它客户端产生的消耗）；
② 信息同步（ListSeatInfos，默认 6 小时）：低频核对席位基础信息——到期时间、RPM/TPM 限流、计费/绑定状态、自动续费等；本地 Key 缺失的到期时间 / 席位 ID 自动补充，其余以快照展示（点击 Key「统计」查看，便于与本地配置核对）。
① 用量同步（GetSeatAFPUsage，默认 5 分钟）：拉取席位的官方真实 AFP 用量（近5小时 / 近1天 / 近1周 / 近1月四窗口，含席位在其它客户端产生的消耗）；
② 信息同步（ListSeatInfos，默认 6 小时）：低频核对席位基础信息——到期时间、RPM/TPM 限流、计费/绑定状态、自动续费等；本地 Key 缺失的到期时间 / 席位 ID 自动补充，其余以快照展示（点击 Key「统计」查看，便于与本地配置核对）。
IAM 子账号或主账号的 Access Key（控制台「IAM 访问控制 → Access Key 管理」获取）
仅首次设置时输入；已保存后留空表示不修改
GetSeatAFPUsage；0 = 停用自动同步（仍可手动触发）；默认 300（5 分钟）
ListSeatInfos；0 = 停用自动同步；默认 21600（6 小时）
Webhook 通知预警 飞书 / 企业微信 / 钉钉 群机器人
可用 Key 比例（当前可路由 / 启用中）或额度池可用 AFP 比例（近5小时 / 近7天 / 月度三层窗口，全部启用 Key 的限额与已用汇总）整体低于阈值时，自动向群机器人 Webhook 发送预警消息；额度优先取官方席位同步数据，未同步的 Key 回退本地估算，不针对单个 Key 告警。指标恢复正常后发送一次恢复通知，同一指标按「重复告警间隔」限流去重。
关闭后不检查、不发送
飞书 / 企微 / 钉钉地址可自动识别；其它服务选「通用 JSON」（发送 {"text": "..."}）
群设置 → 群机器人 → 添加自定义机器人获取
钉钉「加签」密钥（SEC 开头）或飞书「签名校验」密钥；企微无需填写
可用 Key 比例低于该值时告警，0 = 不监控
额度池任一窗口（近5小时 / 近7天 / 月度）整体剩余低于该值时告警，不针对单个 Key，0 = 不监控
同一指标两次告警（含恢复通知）的最小间隔
配置备份与迁移 Key / 访问令牌配置
导出全部上游 Key（可选包含访问令牌）配置为 JSON 文件，用于备份恢复或多实例迁移；导入时按席位 ID / API Key 匹配去重，支持合并 / 仅新增 / 覆盖三种模式。配置文件包含明文密钥，请在可信环境传输与保存。
账户信息
管理员账户，用于登录本管理后台
修改密码
安全建议
· 密码长度至少 6 位，建议包含字母、数字与符号
· 定期更换密码，避免与其他平台共用
· 管理端登录会话有效期 7 天，到期后需重新登录
· 忘记密码：在服务器上执行 ./volc-agent-hub reset-admin 重置（建议先停止服务）
· 定期更换密码，避免与其他平台共用
· 管理端登录会话有效期 7 天，到期后需重新登录
· 忘记密码：在服务器上执行 ./volc-agent-hub reset-admin 重置（建议先停止服务）