主题
密钥与用量
API Key 管理
在「API 密钥」页面创建和管理密钥。推荐:
- 开发、测试和生产环境分别使用不同密钥;
- 为每个应用设置独立额度和有效期;
- 生产服务配置 IP 白名单;
- 不定期轮换密钥;
- 怀疑泄露时立即禁用或删除,而不是等待客服处理。
页面支持按名称、分组等条件筛选或排序,并可对选中的密钥批量修改可编辑属性;批量操作前应核对选择范围和目标分组。分组选择器只会列出当前密钥可用、且与平台能力相符的选项。管理员可限制单个用户同时存在的密钥数量和每小时创建次数;删除后重新创建仍计入当小时次数。
查看用量
「使用记录」提供请求明细和统计信息,包括请求 ID、请求类型、模型、Token、费用、状态、耗时、首 Token 延迟、输出 TPS 及请求时间,并可筛选原生 OpenAI 上下文压缩请求。费用明细最多显示八位小数;页面导出会沿用当前日期、密钥、模型、状态和其他筛选条件,切换分页不会丢失导出范围。推理模型请求还可展示客户端请求的推理强度;普通用户只看到请求侧强度,管理员在发生映射时可另外核对实际上游强度,避免暴露内部映射细节。管理员视图在对应记录存在时还会区分请求模型、发往上游的模型和上游响应模型,并可筛选响应模型是否一致;日期版本差异可能被标记为“疑似版本变体”。管理员为账号配置请求 ID 响应头后,还可查看和导出直接上游的请求 ID,用于跨层排查;该字段不会向普通用户公开。上述审计信息不改变最终扣费依据。分组用量摘要可分别展示今日、昨日和累计费用,仪表盘近期用量可在 Token 与消费额之间切换,统计边界以服务端配置的时区为准。
公开的密钥用量查询可用于查询指定密钥状态。不要在不可信设备或网页中输入密钥。
查看渠道和服务状态
可先通过「模型广场」了解公开的模型、分组与价格。模型广场可能由管理员关闭或要求登录,且展示内容用于选型参考。
登录后可在「可用渠道」查看当前账号可访问的渠道、分组、模型和价格信息。该页面展示的是当前账号视角下的可用范围,不等同于全站所有后台渠道;实际调用能力以 /v1/models 和当前 API Key 为准。
「渠道状态」用于查看管理员公开的渠道监控结果、近期可用性和延迟。管理员可选择 v1 主动探测,或显式切换到 v2 被动聚合;v2 会基于真实请求逐步生成成功率、首 Token 延迟、输出 TPS 分位数、缓存率、趋势、用户排行和错误分类,只有存在请求样本时才计算健康评分,首次启用时历史范围会渐进回填。没有首 Token 样本时页面保持空值,不按零延迟参与比较;管理员也可单独隐藏普通用户的排行标签和数据。v1 监控还可由管理员选择“探活”“配额”或“配额 + 探活”模式,并关联已有账号获取滚动窗口、重置时间或多币种余额;支持范围取决于平台和账号类型,例如 Antigravity 只支持配额模式,MiniMax、OpenCode 等平台是否支持探测或额度取决于账号类型,部分 API Key 账号没有上游用量通道。
出于隐私考虑,管理员可分别隐藏 RPM/TPM 吞吐信息和用户排行。用户端配额/余额展示也默认关闭且由服务端剥离,只有管理员显式开启 channel_monitor_show_quota 后才会公开;管理员视图仍可见。若某个模型突然不可用,先确认渠道状态、分组模型白名单、订阅/余额和密钥限制。
上述监控模式、公开范围和吞吐显示均是管理员配置项;功能关闭时页面或接口可能不可用,不能据此认定实际模型一定不可调用。
复合渠道的被动监控会把错误归因到实际命中的账号平台;运维错误详情支持列表展示并保留筛选状态。排查时仍应同时保存请求 ID、请求时间、请求模型与当前筛选条件。
额度和限流
调用可能同时受到以下限制:
- 用户余额或订阅额度;
- API Key 自身额度;
- 用户、分组或上游账号并发;
- RPM、TPM 或上游动态配额;
- 模型、IP 白名单和有效期限制。
收到 429 时应降低并发并指数退避;收到 402 时检查余额和订阅;收到 403 时检查模型、分组和 IP 设置。
安全建议
API Key 等同于调用凭证。不要写入前端 JavaScript、移动应用安装包、公开 Git 仓库、截图和工单。服务端日志应只记录密钥前后少量字符或不可逆摘要。
账户登录建议启用 TOTP 二次验证。如果「个人资料」中提供 Passkey(通行密钥),可在受信任设备上完成绑定;新增或删除 Passkey 需要验证当前密码。不要在公共设备上绑定 Passkey,设备丢失后应及时移除对应凭证。