新版控制台流程
新版网站将旧控制台拆分为独立页面。登录后可通过左侧导航进入各项功能,页面地址也可以直接收藏。
推荐使用顺序
- 在 概览 检查账户余额、密钥和近期使用情况。
- 在 模型广场 确认模型名称、能力、支持协议和价格。
- 如需补充余额或购买套餐,进入 钱包。
- 在 API 密钥 创建调用凭证,并按需选择固定分组或 Auto 分组,以及限制额度、有效期、模型和 IP。
- 在 游乐场 完成站内测试,或按 API 调用 配置 SDK。
- 请求完成后到 使用日志 或 任务日志 核对结果。
页面导航
| 新版页面 | 地址 | 主要用途 |
|---|---|---|
| 概览 | /dashboard/overview | 账户状态、余额、密钥和近期用量 |
| 数据看板 | /dashboard/models | 模型调用分析、趋势和流量 |
| API 密钥 | /keys | 创建、显示、复制、编辑、启用或停用密钥 |
| 使用日志 | /usage-logs/common | 普通 API 请求、计费、耗时和错误 |
| 任务日志 | /usage-logs/task | 图片、视频等异步任务记录 |
| 钱包 | /wallet | 余额、充值、订阅、兑换码和账单 |
| 个人资料 | /profile | 资料、密码、登录会话、Passkey 和两步验证 |
| 游乐场 | /playground | 在浏览器内测试模型和请求参数 |
| 任务插件(超级管理员) | /task-plugins | 管理内置与自定义异步任务平台 |
INFO
站点管理员可以按账号权限或系统配置隐藏部分菜单。某个入口未显示时,不代表页面故障,请以当前账户实际可见功能为准。
API 密钥的新操作方式
创建密钥时,基础设置包括名称、分组、有效期、数量和额度。高级设置可以限制模型与 IP/CIDR,并决定该密钥能否查询所属账号的剩余与已用额度。新建密钥默认允许额度查询;本次升级前已经存在的密钥保持关闭,可在编辑页明确开启。开启后,GET /api/usage/token/ 会同时返回密钥用量和账号额度;密钥用量、额度与日志查询都会执行该密钥的 IP 白名单检查。
如果管理员启用了 Auto 分组,密钥可以按优先顺序尝试多个可用分组:
- 选择“继承全局 Auto”时,密钥始终使用管理员维护的最新分组顺序;
- 选择自定义顺序时,可为当前密钥单独添加、删除和排序分组;
- 开启“跨组重试”后,当前分组内的渠道不可用时,系统会继续尝试顺序中的下一个分组;
- 实际命中的分组和最终扣费请以使用日志为准。
创建完成后:
- 点击密钥行旁的复制按钮,可复制完整密钥;
- 点击脱敏显示的密钥,可按需查看完整内容;
- 可随时编辑、停用或删除密钥;
- 密钥泄露时应立即停用或删除,再创建新密钥。
钱包与计费
钱包页将余额、充值、订阅、兑换码、邀请奖励和账单记录集中在同一页面。具体显示内容取决于管理员启用的支付与套餐功能。
订阅计费偏好会始终如实显示保存值。没有有效订阅时,「订阅优先」会自动使用钱包,而「仅用订阅」会拒绝请求;页面会显示对应提示,不再把保存值伪装成「钱包优先」。
系统会在进入支付前检查充值数量及充值后的钱包额度;无法安全入账的数量会被直接拒绝,不会继续创建支付。支付回调会在事务中完成订单状态与额度更新,重复回调不会重复增加余额。
最终扣费以 使用日志 中记录的模型、输入输出用量、分组倍率和其他计费项为准。
使用日志的新信息
新版使用日志会更明确地区分普通请求与流式请求,并记录流式响应是否正常完成。日志详情会显示请求记录到的 reasoning effort;使用动态计费规则时,「条件乘数」会标出本次实际命中的条件和倍率。消费金额旁出现工具图标时,表示本次请求包含 Web Search、File Search、图片生成等工具调用附加费;打开日志详情可以查看更完整的计费信息。
普通使用日志页现在可按选定时间范围导出 CSV,并沿用当前页面的其他筛选条件;导出列名使用当前界面语言。普通用户只能导出自己的日志,管理员在“全部用户”视图可导出全部用户日志。同一账号同一时间只能运行一个导出任务;时间范围还受管理员设置的“最长日志时间范围”限制,该限制同时用于普通用户日志查询、个人数据看板和所有导出,默认 365 天。管理员可在「系统设置 → 日志设置 → 日志搜索与导出」关闭普通用户导出,但管理员导出始终可用。
协议转换告警、拒绝原因、渠道链、配额饱和与任务插件诊断统一收纳在日志的管理员信息中。普通用户只能看到公开字段,管理员才能在详情中查看拒绝原因等特权元数据。
分组、密钥名称和用户名筛选框仍是普通文本筛选,但隐藏状态改为页面内遮罩,并关闭浏览器自动填充,避免密码管理器把凭据误填进日志条件。需要核对筛选值时可正常切换显示状态。
游乐场的流式文本会对新到达的普通文字做短暂淡入;行内代码、代码块和已完成内容不会重复动画。编辑历史消息时,如果内容尚未保存,取消编辑或离开页面都会先提示确认,避免误丢修改。
任务日志现在会为插件任务显示统一的任务详情、计费用量事实和可用产物。视频、图片或其他产物通过与具体任务及产物键绑定的访问地址打开;普通用户不会看到渠道密钥、上游任务 ID 等私有信息,管理员与超级管理员看到的诊断字段也按角色分层。
个人资料的「通知」页可分别控制余额不足提醒、渠道通知和上游模型更新通知。余额提醒对所有用户默认开启,并使用个人阈值或站点默认阈值;充值回阈值以上后才会重新触发下一次跨阈值提醒。渠道通知与上游模型更新只向开启它们的管理员发送,根用户在首次明确关闭前默认接收渠道通知。验证码、密码重置、邮箱绑定和账号安全邮件只依赖 SMTP,不受这些通知开关影响。
从旧地址迁移
旧控制台链接仍可能被自动重定向,但建议更新书签和客户端说明:
| 旧入口 | 新入口 |
|---|---|
/console | /dashboard/overview |
/console/token | /keys |
/console/log | /usage-logs/common |
/console/task | /usage-logs/task |
/console/topup | /wallet |
管理员功能已分别移动到「渠道」「模型」「用户」「订阅」「系统信息」和「系统设置」页面,普通用户不会看到这些入口。
管理员渠道与兑换码操作
渠道列表新增可选的拖拽排序模式,表格和卡片视图都能把渠道放到同优先级、某优先级之前或之后,并实时预览系统将写入的优先级。拖拽模式默认关闭;首次使用会显示可暂停、重放的引导。提交前若检测到并发修改会拒绝覆盖,成功调整后可撤销。
异步图片、视频等任务平台已迁移到沙箱 JavaScript 插件。超级管理员可在「任务插件」页面查看出厂插件、从市场安装插件或上传自定义插件;同名自定义版本会覆盖出厂版本,停用或删除覆盖版本后恢复出厂版本。关闭总开关会同时停止出厂与自定义插件,并影响仍在途的任务,请先核对页面列出的渠道数与在途任务数。
正在直接使用出厂版本的插件只随系统发布更新,市场卡片会显示「随系统更新」而不提供安装按钮,避免无意创建永久覆盖。已经覆盖出厂插件的自定义版本仍可安装或升级;当它与当前内置版本不同时,列表会提示删除自定义版本可恢复到哪个内置版本。
任务插件模型可通过渠道 model_mapping 提供别名,并识别同一已声明模型的大小写变体。若请求的模型被某插件声明但当前分组没有已启用的对应渠道,503 错误会指出占用该模型的插件;管理员应启用正确渠道,或按需停用/覆盖该出厂插件。
任务轮询会区分 404/410 终止、401/403 认证问题、429/5xx、网络错误和无法识别的返回。后四类会累计连续失败,一次有效的 2xx 非终态返回会清零;达到 TASK_POLL_MAX_FAILURES(默认 20)后任务失败并进入既有结算/退款链路。TASK_TIMEOUT_MINUTES(默认 1440)仍是总超时保护。
中继 HTTP 客户端默认最多等待上游响应头 1800 秒,之后的流式传输不受该限制。可通过 RELAY_RESPONSE_HEADER_TIMEOUT 调整,0 恢复无上限;非流式请求通常在生成完成后才返回响应头,不要设置过短。
创建任务插件渠道时必须选择已注册插件并填写 Base URL;具备 task_plugin.bind 权限的管理员才能绑定。插件声明的模型、公开路由、OpenAI Responses / Video 协议能力和计费用量字段会共同决定可用接口与定价编辑器;插件冲突或公开路由冲突不会被市场安装强制覆盖。系统设置中的「任务公开地址」用于生成任务产物地址,未配置时才回退到服务器地址。
上传任务插件时会展示插件声明的请求域名,便于管理员在安装前审查外部访问范围。插件驱动钩子可以通过受控的 utils.fetch 读取上游数据;需要保持 JSON 成员顺序的插件可声明 json-order@1。阿里百炼和豆包的图片模型现由任务插件接管 OpenAI Images 接口,旧渠道配置应使用插件声明的模型名或通过渠道模型映射对齐。
管理员在「渠道」中抓取上游模型后,新增模型与已有模型会按厂商分组展示,便于搜索、批量选择和核对;Qwen 的 TTS 模型会归入 Qwen 分类。保存前仍应检查模型名称和映射,无法识别的名称会显示在 Other 分组。
渠道连通性测试会按所选协议发送请求:Claude 和 Gemini 使用各自的原生请求格式,Gemini 流式测试使用 :streamGenerateContent 路径。因此测试成功表示该渠道的对应原生协议入口可用,不代表同一模型自动支持其他协议。
渠道高级设置提供「跳过上游 TLS 证书校验」开关,仅应用于该渠道自己的 HTTP 传输。该选项会降低连接安全性,只应在受控的自签名或内部网络环境中使用,不要把它作为公共上游证书错误的常规处理方式。
AWS 渠道可显式选择 Mantle Messages API;未配置的现有渠道仍使用 InvokeModel。Mantle 模式支持 Claude 原生响应、API Key 或 SigV4 认证以及顶层 cache_control。Vertex API Key 模式可选填 Project ID:填写后请求 URL 会包含项目与区域(包括 global、us、eu 多区域主机),留空则保留 Express/旧版 URL 行为。
在「系统设置 → 模型与渠道 → 路由可靠性」中,定时渠道测试支持三种范围:检查除手动禁用外的全部渠道、只检查已开启自动禁用的渠道、或只复查等待恢复的自动禁用渠道。后两种模式可减少对健康渠道的不必要探测;是否在测试成功后重新启用渠道仍由对应开关控制。管理员还可把测试并发设置为 1–32;任务会按该上限并行执行,同时保留进度统计和取消能力。
Advanced Custom 渠道现在提供可视化路由编辑器,可从全部协议、仅 OpenAI、仅 Claude 或仅 Gemini 模板开始,再按实际需要保留路由。每条转发路由可分别配置入口路径、上游路径、协议转换、认证方式和精确模型范围;同一路径可按模型拆分,但只能保留一个最终兜底路由。模型列表与余额查询属于独立的管理路由,替换转发模板时会保留;余额响应若不是 OpenAI credit_summary 格式,只显示原始上游 JSON,不会错误更新渠道余额。
OpenAI、Anthropic、Codex、Advanced Custom、Sub2API 和 New API 等兼容或网关渠道会按协议显示「字段透传控制」。只启用上游确实支持的字段;例如 service_tier、inference_geo、speed、store 或 obfuscation 控制在不同协议中的支持范围并不相同。参数覆盖规则还可以读取 user_id、user_group、token_group 和实际命中的 using_group,用于按用户或分组调整上游参数。
配置自定义 OAuth 提供商时,「访问策略」可以直接填充「等级且已激活」或「组织或角色」模板,并支持嵌套的 and / or 条件。拒绝提示可使用 provider、field、op、required、current 及 current.roles 等变量;访问策略留空表示不额外限制用户。
管理员在用户绑定管理中可以解绑邮箱、GitHub、Discord、微信、OIDC、Telegram 和 LinuxDO 等内置登录方式。服务端设置 PASSWORD_LOGIN_ENCRYPTION_ENABLED=true 后,登录页会先读取临时公钥并加密密码字段再提交;该能力默认关闭,关闭时继续使用原有登录请求格式。
密码登录页会显示站点隐私政策和服务条款的同意提示;该提示只说明登录行为的法律含义,不替代服务端认证与会话校验。
编辑兑换码时,页面会先加载服务器上的最新记录;加载完成前不能提交。若只修改名称或有效期而没有改动额度,系统会保留原始内部额度,避免因显示货币换算和小数精度造成额度变化。额度输入步长会随当前货币或 Token 显示设置调整。
个人资料中的访问令牌不会回显现有值,重新生成前必须确认。生成后的新令牌只显示一次,关闭窗口后即从页面清除,同时旧令牌会立即失效;请先安全保存新值,再立即更新仍使用旧令牌的客户端。该操作还受关键接口限流约束,不要连续重复生成。
控制台访问令牌已改为可命名、可编辑权限范围的访问令牌。超级管理员执行用户管理等敏感操作时还需要完成二次验证;普通管理员不能创建非标准角色,也不会看到仅超级管理员可用的系统设置入口。